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• Python manuals, authors: Guido van Rossum and Fred Drake 

• python-mode.el, author: Tim Peters 

• and the readers of comp.lang.python 

UsefuI links : 

• Python's nest: http://www.python.org 

• OfficiaI documentation: http://docs.python. 0 rg/ 2 . 6 / 

• Other doc & free books: FAQs, Faqts, Dive into Python, Python Cookbook, Thinking in Python, Text Processing in 
Python 

• Getting started: Python Tutoriai, 7mn to Heiio Worid (Windows) 

• Topics: HOWTOs, Databases, Web programming, XML, Web Services, Parsers, Numeric & Scientific Computing, GUI 
programming, Distributing 

• Where to find packages: Python Package Index (PyPI), Python Eggs, SourceForge (search "python"), Easy InstaiI, 
0'Reiiiy Python DevCenter 

• Wiki: moinmoin 

• Newsgroups: comp.lang.python and comp.iang.python.announce 

• Misc pages: Daiiy Python URL 

• Python Development: http://www.python.org/dev/ 

• Jython - Java implementation of Python: http://www.jython.org/ 

• IronPython - Python on .Net: http://www.codepiex.com/Wiki/View.aspx?ProjectName=IronPython 

• ActivePython: http://www.ActiveState.com/ASPN/Python/ 

• Help desk: help@python.org 

• 2 exceiient (but somehow outdated) Python reference books: Python EssentiaI Reference (Python 2.1) by David 
Beaziey & Guido Van Rossum (Other New Riders) and Python in a nutsheii by Aiex marteiii (0'Reilly). 

• Python 2.4 Reference Card (cheatsheet) by Laurent Pointal, designed for printing (15 pages). 

• Oniine Python 2.2 Quick Reference by the New Mexico Tech Computer Center. 

Tip: From within the Python interpreter, type heip, heip (object) or heip ("name") to get help. 


Invocation Options 


python[w] [-BdEhimOQsStuUvVWxXS?] [-c command \ scriptFile \ - ] [args] 
(pythonw does not open a terminal/console; python does) 


Invocation Options 

Option 

Effect 

-B 

Prevents module imports from creating .pyc or .pyo files (see also envt variable 

PYTHONDONTWRITEBYTECODE=x and attribute sys . dont write bytecode). 

-d 

Output parser debugglng Information (also PYTHONDEBUG=x) 

-E 

Iqnore environment variables (such as PYTFIONPATFI) 

-h 

Print a heip message and exit (formerly -?) 

-i 

Inspect interactively after running script (also PYTHONINSPECT=x) and force prompts, even if stdin 
appears not to be a terminal. 

-m module 

Search for module on sys.path and runs the module as a script. (Implementation improved in 2.5: 
module runpy) 

-0 

Optimize qenerated bytecode (also PYTFIONOPTIMIZE=x). Asserts are suppressed. 

-00 

Remove doc-strinqs in addition to the -0 optimizations. 

-Q arg 

Division options: -Oold (default), -Owarn, -Owarnall, -Qnew 

-s 

Disables the user-specific module path (also PYTFIONNOUSERSITE=x) 

-s 

Don't perform import site on initialization. 

-t 

Issue warninqs about inconsistent tab usaqe (-tt: issue errors). 

-u 

Unbuffered binary stdout and stderr (also PYTFIONUNBUFFERED=x). 

-u 

Force Python to interpret all strinq literais as Unicode literals. 

-V 

Verbose (trace import statements) (also PYTHONVERBOSE=x). 

-V 

Print the Python version number and exit. 

-W arg 

Warninq controi (arg is action:message:category:module:lineno) 

-X 

Skip first line of source, allowing use of non-unix Forms of #! cmd 

-X- 

Disable class bosed built in exceptions (for backward compatibility manaqement of cxccptions) 

-3 

Emit a Deprecationwarning for Python 3.X incompatibilities 

-C 

Specify the command to execute (see next section). This terminates the option list (following 
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command 

options are passed as arguments to the command). 

script File 

The name of a python file (.py) to execute. Read from stdin. 

- 

Proqram read from stdin (default; interactive mode if a tty). 

args 

Passed to script or command (in sys. argv [ i: ]) 


If no scriptFile or command, Python enters interactive mode. 


• Available IDEs in std distrib: IDLE (tkinter based, portable), Pythonwin (on Windows). Other free IDEs: 
IPython (enhanced interactive Python shell), Eric, SPE, BOA constructor, PyDev (Eclipse plugin). 

• Typical python module header : 

#!/usr/bin/env python 

# coding: latinl 

Since 2.3 the encoding of a Python source file must be declared as one of the two first lines (or defaults to 7 
bits Ascii) [PEP-0263], with the format: 

# coding: encoding 

std encodings are defined here, e.g. ISO-8859-1 (aka latinl), iso-8859-15 (Iatin9), UTF-8... Not all encodings 
supported, in particular UTF-16 is not supported. 

• It's now a syntax error if a module contalns string llterais wIth 8-bit characters but doesn't have an encoding 
declaration (was a warning before). 

• Since 2.5, from _future_ import feature statements must be declared at beginning of source file. 

• Site customization: File sitecustomize .py Is automatically loaded by Python if it exists in the Python path 
(ideally located in $ {pythonhome } /lib/site-packages/). 

• Tip: when launching a Python script on Windows, 

<pythonHome>\python myScript.py args ... can be reduced tO : 

myscript.py args ... if <pythonHome> is in the PATH envt variable, and further reduced to : 
myscript args . .. provided that .py; .pyw; .pyc; .pyo is added to the PATHEXT envt variable. 


Environment variables 


Environment variables 

Variable 

Effect 

PYTHONHOME 

Alternate prefix directory (or prefix\exec_prefix). The default module search 
path uses prefix/Wb 

PYTHONPATH 

Augments the default search path for module files. The format is the same as 
the sheifs $path: one or more directory pathnames separated by or 
without spaces around (semi-) colons I 

On Windows Python first searches for Registry key 

HKEY_LOCAL_MACHINE\Software\Python\PythonCore\x.y\PythonPath (default 

value). You can create a key named after your appllcation with a default string 
value giving the root directory path of your appl. 

Alternatively, you can create a text file with a .pth extension, contalning the 
path(s), one per line, and put the file somewhere In the Python search path 
(Ideally In the site-packages/ directory). It's better to create a .pth for each 
appllcation, to make easy to uninstall them. 

PYTHONSTARTUP 

If this is the name of a readable file, the Python commands In that file are 
executed before the first prompt is displayed in interactive mode (no default). 

PYTHONDEBUG 

If non-empty, same as -d option 

PYTHONINSPECT 

If non-empty, same as -1 option 

PYTHONOPTIMIZE 

If non-empty, same as -0 option 

PYTHONUNBUFFERED 

If non-empty, same as -u option 

PYTHONVERBOSE 

If non-empty, same as -v option 

PYTHONCASEOK 

If non-empty, iqnore case in file/module names (imports) 

PYTHONDONTWRITEBYTECODE 

If non-empty, same as -B option 

PYTHONIOENCODING 

AlternatG encodingname Or encodingname : errorhandler for Stdin, Stdout, and 
stderr, with the same choices accepted by str.encode o . 

PYTHONUSERBASE 

Provides a private site-packages directory for user-specific modules. [PEP- 
0370] 

- On Unix and Mac OS X, defaults to ~/.iocai/, and modules are found In a 
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version-specific subdirectory like lib/python2.6/site-packages. 

- On Windows, defaults to %APPDATA%/Python and Python26/site-packages. 

PYTHONNOUSERSITE 

If non-empty, same as -s option 


Notable lexical entities 


Key words 


and 

dei 

for 

is 

raise 

assert 

elif 

from 

lambda 

return 

break 

else 

global 

not 

try 

class 

except 

if 

or 

while 

continue 

exec 

import 

pass 

with 

def 

finally 

in 

print 

yield 


• (List of keywords available in std moduie: keyword) 

• liiegitimate Tokens (oniy vaiid in strings): $ ? (pius @ before 2.4) 

• A statement must aii be on a singie line. To break a statement over multiple lines, use as with the C 
preprocessor. 

Exception : can always break when inside any (), [], or {} pair, or in triple-quoted strings. 

• More than one statement can appear on a line if they are separated with semicolons (";"). 

• Comments start with "#" and continue to end of line. 

Identifiers 

{letter \ {letter | digit \ 

• Python identifiers keywords, attributes, etc. are case-sensitive. 

• SpeciaI forms: _ident (not imported by 'from module import *');_ ident _(system defined name);_ ident 

(class-private name mangling). 

String literais 

Two flavors: str (Standard 8 bits locale-dependent strings, like ascii, iso 8859-1, utf-8, ...) and Unicode (16 or 32 
bits/char in utf-16 mode or 32 bits/char in utf-32 mode); one common ancestor basestring. 


Literal 

"a string enclosed by double quotes" 

'another strinq delimited by sinqle quotes and with a " inside' 

'"a strinq containinq embedded newlines and quote (') marks, can be delimited with triple quotes."' 

""" may also use 3- double quotes as delimiters """ 

b"An 8-bit string" - A bytes instance, a forward-compatible form for an 8-bit string' 

B"Another 8-bit string" 

u'a Unicode strinq' 

U"Another Unicode strinq" 

r'a raw strinq where \ are kept (literalized): handy for requiar expressions and Windows pathsi' 

R"another raw strinq" — raw strinqs cannot end with a \ 

ur'a Unicode raw string' 

UR"another raw Unicode" 


• Use \ at end of line to continue a string on next line. 

• Adjacent strings are concatened, e.g. 'Monty ’ 'Python' is the same as 'Monty Python'. 

• u'heiio' + ' World' -->u'heiio worid' (coerced to Unicode) 


String Literal Escapes 

Escape 

Meaning 

\neiv//ne 

Iqnored (escape newline) 

W 

Backslash (\) 

\e 

Escape (ESC) 

\v 

Vertical Tab (VT) 
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\' 

Singie quote (') 

\f 

Formfeed (FF) 

\ooo 

char with octal value ooo 

\" 


\n 

Linefeed (LF) 

\a 

Bell (BEL) 

\r 

Carriage Return (CR) 

\xhh 

char with hex value hh 

\b 

Backspace (BS) 

\t 


\uxxxx 

Character with 16-bit hex value xxxx (Unicode only) 

\Uxxxxxxxx 

Character with 32-bit hex value xxxxxxxx (Unicode only) 

\N{name} 

Character named in the Unicode database (Unicode only), e.g. u' \NiGreek smaii letter 

Pi} ' < = > u’\u03c0’ . 

(Conversely, in module unicodedata, unicodedata.name (u’ \u03c0 ') == 'greek small 

LETTER PI ' ) 

\AnyOtherChar 

left as-is, including the backslash, e.g. str (' \z ’) == '\\z' 


• NUL byte (\000) is not an end-of-string marker; NULs may be embedded in strings. 

• Strings (and tupies) are immutabie : they cannot be modified. 


Boolean constants (since 2.2.1) 

• True 

• False 

In 2.2.1, True and False are integers 1 and 0. Since 2.3, they are of new type booi. 


Numbers 

• Decimal integer: 1234, 1234567890546378940 l (ori) 

• Binary integer: Obio, obio, ObioioioioioioioioioioioioioioioiOL (begins with a Ob or ob) 

• Octal integer: 0177 , O0177, 00177, 01777777777777777771 (begins with a 0 , Oo, or 00) 

• Hex integer: Oxff, oxfffff£££ffffffffffl (begins with Ox or ox) 

• Long integer (uniimited precision): 1234567890123456 l (ends with l or 1) or iong(i234) 

• Float (double precision): 3 .14e-10, . 001 , 10 ., ie3 

• Complex: u, 2+3J, 4+5 j (ends with j or j, + separates (float) real and imaginary parts) 
Integers and long integers are unified starting from release 2.2 (the l suffix is no longer required) 


Sequences 


• Strings (types str and Unicode) of length 0, 1, 2 (see above) 

", '1', "12", 'hello\n' 

• Tupies (type tupie) of length 0, 1, 2, etc: 

() (1,) (1,2) # parentheses are optional if len > 0 

• Lists (type list) of length 0, 1, 2, etc: 

[] [ 1 ] [ 1 , 2 ] 

• Indexing is 0-based. Negative indices (usually) mean count backwards from end of sequence. 

• Sequence slicing [starting-at-index : but-less-than-index [ : stepj]. Start defaults to 0, end to len(sequence), 
step to 1. 

a = (0,1,2,3,4,5,6,7) 

a[3] == 3 

a[-l] == 7 

a[2:4] == (2, 3) 

a[l:] == (1, 2, 3, 4, 5, 6, 7) 

a[:3] == (0, 1, 2) 

a[:] == (0,1,2, 3, 4, 5, 6, 7) # makes a copy of the sequence. 

a[::2] == (0, 2, 4, 6) # Only even numbers. 

a[::-l] ^ (7, 6, 5, 4, 3 , 2, 1, 0) # Reverse order. 

Dictionaries (Mappings) 
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Dictionaries (type dict) of length 0, 1, 2, etc: ■{> {1 : 'first'} {1 : 'first', 'two': 2, key.value} 
Keys must be of a hashable type; Values can be any type. 


Op erators and their evaluation order 


Operators and their evaluation order 

Highest 

Operator 

Comment 


, [...] <...} '...' 

Tuple, list & dict. creation; string conv. 


s[i] s[i:i] s.attrf(...) 

indexing & slicing; attributes, fct calls 


+ X, -X, «''X 

Unary operators 



Power 


x*y x/y x°/oy 

mult, division, modulo 


x+y x-y 

addition, substraction 


x<<y x>>y 

Bit shifting 


x&y 

Bitwise and 


x^^y 

Bitwise exclusive or 


x|y 

Bitwise or 


x<y x<=y x>y x>=y x==yx!=y xoy 

Comparison, 


X is y X is not y 

identity, 


X in s X not in s 

membership 


not X 

boolean negation 


X and y 

boolean and 


X or y 

boolean or 

Lowest 

lambda args: expr 

anonymous function 


• Alternate names are defined in module operator (e.g._ add _and add for +) 

• Most operators are overridable 


Basic types and their operations 

Comparisons (defined between any types) 


Comparisons 

Comparison 

Meaning 

Notes 

< 

strictiy less than 

(1) 

< = 

less than or equal to 


> 

strictiy greater than 


> = 

greater than or equal to 


= = 

equal to 


!= or <> 

not equal to 


is 

object identity 

(2) 

is not 

neqated object identity 

(2) 


Notes : 

• Comparison behavior can be overridden for a given class by defining speciai method_cmp. 

• (1)X<Y<Z<W has expected meaning, uniike C 

• (2) Compare object identities (i.e. id(object)), not object values. 

None 


• None is used as default return value on functions. Built-in singie object with type Noneiype. Might become a keyword in 
the future. 

• Input that evaluates to None does not print when running Python interactively. 

• None is now a constant; trying to bind a value to the name "None" is now a syntax error. 


Boolean operators 

Boolean values and operators 
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Value or Operator 

Evaluates to 

Notes 

built-in bool(expr) 

True if expr is true. False otherwise. 

see True, False 

None, numeric zeros, empty sequences and mappings 

considered False 


ali other values 

considered True 


not X 

True if X is False, eise False 


X or K 

if X is False then y, eIse x 

(1) 

X and y 

if X is False then x, eise y 

(I) 


Notes : 

• Truth testing behavior can be overridden for a given class by defining speciai method_nonzero_. 

• (1) Evaluate second arg oniy if necessary to determine outcome. 

Numeric types 

Floats, integers, long integers, Decimals. 

• Floats (type fioat) are implemented with C doubles. 

• Integers (type int) are implemented with C longs (signed 32 bits, maximum value is sys .maxint) 

• Long integers (type long) have uniimited size (oniy limit is System resources). 

• Integers and long integers are unified starting from release 2.2 (the L suffix is no longer required). int () returns a 
long integer instead of raising overfiowError. Overflowing operations such as 2«32 no longer trigger Futurewarning 
and return a long integer. 

• Since 2.4, new type oecimai introduced (see module: decimal) to compensate for some limitations of the floating point 
type, in particular with fractions. Uniike floats, decimal numbers can be represented exactiy; exactness is preserved in 
calculations; precision is user settable via the context type [PEP 327]. 


Operators on ali numeric types 


Operators on all numeric types 

Operation 

Resuit 

abs(x) 

the absolute value of x 

int(x) 

X converted to integer 

long(x) 

X converted to long integer 

float(x) 

X converted to floating point 

-X 

X neqated 

+x 

X unchanqed 

X + y 

the sum of x and y 

x-y 

difference of x and y 

X * y 

product of X and y 

X ! y 

true division of x by y: 1/2 -> 0.5 (1) 

xHy 

floor division operator: 1//2 -> 0 (1) 

X % y 

X modulo y 

divmod(x, y) 

the tuple (x//k, x%y) 

X ** / 

X to the power y (the same as pow(x,k)) 


Notes : 

• (1) / is stili a /7oor division (1/2 == 0) uniess validated by a from _future_ import division. 

• classes may override methods_ truediv _and_ fioordiv _to redefine these operators. 

BIt operators on Integers and long Integers 


Bit operators 

Operation 

Resuit 


the bits of X inverted 

X ^ K 

bitwise exclusive or of x and y 

X & y 

bitwise and of x and y 

X 1 y 

bitwise or of x and y 

X << n 

X shifted left by n bits 

X >> n 

X shifted right by n bits 


Complex Numbers 

• Type complex, represented as a pair of machine-level double precision floating point numbers. 

• The real and imaginary value of a complex number z can be retrieved through the attributes z.real and z.imao . 
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Numeric exceptions 

TypeError 

raised on applicatiori of arithmetic operation to non-number 

OverflowError 

numeric bounds exceeded 

ZeroDivisionError 

raised when zero second argument of div or modulo op 


Operations on all sequence types (lists, tuples, strings) 


Operations on all sequence types 

Operation 

Resuit 

Notes 

X in S 

True if an item of s is equai to x, eise False 

(3) 

X not in s 

False if an item of s is equai to x, eise True 

(3) 

sl + s2 

the concatenation of sl and s2 


s * n, n*s 

n copies of s concatenated 


s[/] 

/'th item of s, oriqin 0 

(1) 

s[i: n 
s[/: /:step] 

Siice of s from ; (inciuded) to j(exciuded). Optionai step vaiue, possibiy negative 
(defauit: 1). 

(1), (2) 

s.count(x) 

returns number of /'s for which s[/] = = x 


s.index(x[, start[, 
stopll) 

returns smaiiest / such that s[/] = =x. start and stop limit search to oniy part of 
the sequence. 

(4) 

len(s) 

Lenqth of s 


min(s) 

Smaiiest item of s 


max(s) 

Larqest item of s 


reversed(s) 

[2.4] Returns an iterator on s in reverse order. s must be a sequence, not an 
iterator (use reversed(iist (s) ) in this case. [PEP 322] 


sorted(/tera£)/e [, 
cmp] 

[, cmp=cmpFct] 

[, key=/ceyGetter] 

[, reverse=boo/1) 

[2.4] Works like the new in-piace iist.sort(), but sorts a new iist created from 
the iterable. 



Notes : 

• (1) if / or j is negative, the index is reiative to the end of the string, ie len(s)+/ or ien(s)+j is substituted. But 
note that -0 is stiii 0. 

• (2) The siice of s from / to j is defined as the sequence of items with index k such that i< = k < j. 

If / or j is greater than len(s), use ien(s). If j is omitted, use len(s). If / is greater than or equai to j, the siice is 
empty. 

• (3) For strings: before 2.3, x must be a singie character string; Since 2.3, x in s is True if x is a substring of s. 

• (4) Raises a vaiueError exception when x is not found in s (i.e. out of range). 


Op erations on mutable sequences (type iist) 


Operations on mutable sequences 

Operation 

Resuit 

Notes 

s[/] =x 

item / of s is repiaced by x 


s [/:7 [:step]] = t 

siice of s from i to / is repiaced by t 


dei s[/: 7 [:step]] 

same as s[/: 7 ] = [] 


s.append(x) 

same as s[ien(s) : ien(s)] = [x] 


s.extend(x) 

same as s[ien(s):ien(s)]= x 

(5) 

s.count(x) 

returns number of /'s for which s[/] == x 


s.index(x[, start[, stop]]) 

returns smaiiest / such that s[/] = =x. start and stop iimit search to 
oniy part of the iist. 

(1) 

s.insert(/, x) 

same as s[/:/] = [x] if/>= 0. / == -1 inserts before the iast eiement. 


s.remove(x) 

same as dei s[s.index(x)] 

(1) 

s.pop([/]) 

same as x = s[i]; dei s[i]; return x 

(4) 

s.reverseO 

reverses the items of s in piace 

(3) 

s.sort([cmp ]) 
s.sort([cmp=cmpFct] 

[, key=/ceyGetter] 

[, reverse=t)oo/]) 

sorts the items of s in piace 

(2), (3) 
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Notes : 

• (1) Raises a vaiueError exception when x is not found in s (i.e. out of range). 

• (2) The sort() method takes an optional argument cmp specifying a comparison function takings 2 list items and 
returning -1, 0, or 1 depending on whether the Ist argument is considered smaller than, equal to, or larger 
than the 2nd argument. Note that this siows the sorting process down considerably. Since 2.4, the cmp 
argument may be specified as a keyword, and 2 optional keywords args are added: key is a fct that takes a list 
item and returns the key to use in the comparison (faster than cmp); reverse: If True, reverse the sense of 
the comparison used. 

Since Python 2.3, the sort is guaranteed "stable". This means that two entries with equal keys will be returned 
in the same order as they were input. For example, you can sort a list of people by name, and then sort the list 
by age, resulting in a list sorted by age where people wIth the same age are In name-sorted order. 

• (3) The sort 0 and reverse () methods modify the list in place for economy of space when sorting or 
reversing a large list. They don't return the sorted or reversed list to remind you of this side effect. 

• (4) The popo method is not supported by mutable sequence types otherthan lists. The optional argument I 
defaults to -1, so that by default the last item is removed and returned. 

• (5) Raises a TypeError when x is not a list object. 


Op erations on mappings / dictionaries (type dict) 


Operations on mappings 

Operation 

Resuit 

Notes 

len(d) 

The number of items in d 


dicto 

dict(**/cwargs) 

dict(/terab/e) 

dict(d) 

Creates an empty dictionary. 

Creates a dictionary init with the keyword args 
kwargs. 

Creates a dictionary init with (key, value) palrs 
provided by iterable. 

Creates a dictionary which is a copy of dictionary d. 


d.fromkeys(/tera£)/e, va/ue=None) 

Class method to create a dictionary with keys 
provided by iterator, and all values set to value. 


mi 

The item of d with key k 

(1) 

X 

II 

Set d\k] to X 


dei d\k] 

Removes dfkl from d 

(1) 

d.clearO 

Removes all items from d 


d.copyO 

A shallow copy of d 


d.has_key(/c) 
k \n d 

True if d has key k, eise False 


d.itemsO 

A copy of d's list of (key, item) pairs 

(2) 

d.keysO 

A copy of d's list of keys 

(2) 

dJ.update(d2) 

for k, V in d2.items(): dl[k] = v 

Since 2.4, update(**/fwargs) and update(/terad/e) 
may also be used. 


d.valuesO 

A copy of d's list of values 

(2) 

d.get{k, defaultval) 

The item of d with key k 

(3) 

d.setdefau\t(kl,defaultval]) 

d[k] if k in d, eIse defaultval{a\so setting it) 

(4) 

d.iteritemsO 

Returns an iterator over (key, value) pairs. 


d.iterkeysO 

Returns an iterator over the mappinq's keys. 


d.itervaluesO 

Returns an iterator over the mappinq's values. 


d.pop(/c[, default]) 

Removes key k and returns the corresponding value. 

If key Is not found, default Is returned if given, 
otherwise KeyError is raised. 


d.popitemO 

Removes and returns an arbitrary (key, value) palr 
from d 



Notes : 

• TypeError is raised if key is not acceptable. 

• (1) KeyError is raised if key k is not in the map. 

• (2) Keys and values are listed in random order. 

• (3) Never raises an exception if k is not in the map, instead it returns defaultval. defaultval is optional, when 
not provided and k Is not In the map. None Is returned. 

• (4) Never raises an exception If k is not in the map, instead returns defaultval, and adds k to map with value 
defaultval. defaultval is optional. When not provided and k is not in the map. None is returned and added to 
map. 
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Op erations on strings (types str & Unicode) 


These string methods largely (but not completely) supersede the functions available in the string module. 
The str and Unicode types share a common base class basestring. 


Operatioris on strings 

Operation 

Resuit 

Notes 

s.capitalizeO 

Returns a copy of s with its first character capitalized, and the rest of the 
characters lowercased. 


s.center(iv/dt/i[, 
fillChar=' ']) 

Returns a copy of s centered in a string of length width, surrounded by the 
appropriate number of filIChar characters. 

(1) 

s.count('sub[, start[, 
endW 

Returns the number of occurrences of substring sub in string s. 

(2) 

s.decode(lencoding[, 

errors']']) 

Returns a Unicode String representing the decoded version of str s, using 
the given codec (encoding). UsefuI when reading from a file or a I/O 
function that handies oniy str. Inverse of encode. 

(3) 

s.encode([encoding[, 

errors']']) 

Returns a str representing an encoded version of s. Mostly used to 
encode a Unicode string to a str in order to print it or write it to a file 
(since these I/O functions oniy accept str), e.g. u’legere’ .encode 
(' utf 8 ’ ). Also used to encode a str to a str, e.g. to zip (codec 'zip') or 
uuencode (codec 'uu') it. Inverse of decode. 

(3) 

s.endsw\th(suffix [, 
start[, end]]) 

Returns True if s ends with the specified suffix, otherwise return false. 

Since 2.5 suffix can also be a tuple of strings to try. 

(2) 

s.expandtabs 

([tabsize]) 

Returns a copy of s where ali tab characters are expanded using spaces. 

(4) 

s.findfsub [,start 

Lend]]) 

Returns the lowest index in s where substring sub is found. Returns -1 if 
sub is not found. 

(2) 

s.format(*args, 

*kwargs) 

Returns s after replacing numeric and named formatting references found 
in braces {}. (detaiis) 


s.indexfsubC, start[, 
end]]) 

like find(), but raises vaiueError when the substring is not found. 

(2) 

s.isalnumO 

Returns xrue if ali characters in s are alphanumeric. False otherwise. 

(5) 

s.isalphatj 

Returns xrue if ali characters in s are alphabetic. False otherwise. 

(5) 

s.isdigit(9 

Returns xrue if ali characters in s are digit characters. False otherwise. 

(5) 

s.islowertj 

Returns xrue if ali characters in s are lowercase. False otherwise. 

(6) 

s.isspacetj 

Returns xrue if ali characters in s are whitespace characters. False 
otherwise. 

(5) 

s.istitIeO 

Returns xrue if string s is a titiecased string. False otherwise. 

(7) 

s.isupperfj 

Returns xrue if ali characters in s are uppercase. False otherwise. 

(6) 

separator. join('se( 7 j 

Returns a concatenation of the strings in the sequence seq, separated by 
string separator, e.g.: join ([ 'A', 'b', 'C']) ->"a,b,c" 


s.Ijust/rjust/center 

(width\, fillChar=' '1) 

Returns s left/right justified/centered in a string of length width. 

(1), (8) 

s.lowerO 

Returns a copy of s converted to lowercase. 


s. Istri p('[c/7ars] ) 

Returns a copy of s with leading chars (default: blank chars) removed. 


s. partitionfseparj 

Searches for the separator separ in s, and returns a tuple (head, sep, 
tali) containing the part before it, the separator itself, and the part after 
it. If the separator is not found, returns (s, ", "). 


s.replaceto/d, newl, 
maxCount =-l]j 

Returns a copy of s with the first maxCount (-1: uniimited) occurrences of 
substring oid replaced by new. 

(9) 

s.rfindtsub[, start[, 
end]]} 

Returns the highest index in s where substring sub is found. Returns -1 if 
sub is not found. 

(2) 

s.rindex('sub[, storft, 
end]]} 

like rfindO, but raises vaiueError when the substring is not found. 

(2) 

s. rpartitionfseparj 

Searches for the separator separ in s, starting at the end of s, and returns 
a tuple (head, sep, tali) containing the (left) part before it, the 
separator itself, and the (right) part after it. If the separator is not found, 
returns (", ", s). 


s.rstript[cbars]J 

Returns a copy of s with trailing c/7ars(default: blank chars) removed, e.g. 
aPath.rstrip (' / ’) will remove the trailing '/'from aPath if it exists 


s.splittt separatori, 
maxsplit] ]} 

Returns a list of the words in s, using separator as the delimiter string. 

(10) 
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s.rsplit('[ separatori, 
maxsplit]]) 

Same as spiit, but splits from the end of the string. 

(10) 

s.splitiines 

([ keepends]) 

Returns a list of the lines in s, breaking at line boundaries. 

(11) 

s.startswithfpreffx [, 

startl, end]]) 

Returns xrue if s starts with the specified prefix, otherwise returns False. 
Negative numbers may be used for start and end. Since 2.5 prefix can 
also be a tuple of strings to try. 

(2) 

s.strip('[cbarsp 

Returns a copy of s with leading and trailing c/7ars(default: blank chars) 
removed. 


s.swapcasef) 

Returns a copy of s with uppercase characters converted to lowercase and 
vice versa. 


s.titief) 

Returns a titiecased copy of s, i.e. words start with uppercase characters, 
ali remaining cased characters are lowercase. 


s.translate('fab/e[, 

deletechars='']) 

Returns a copy of s mapped through translation table table. Characters 
from deletechars are removed from the copy prior to the mapping. Since 

2.6 table may also be None (identity transformation) - usefui for using 
translate to delete chars oniy. 

(12) 

s.upperO 

Returns a copy of s converted to uppercase. 


s.zfiUiwidth) 

Returns the numeric string left filled with zeros in a string of length width. 



Notes : 

• (1) Padding is done using spaces or the given character. 

• (2) If optional argument start is suppiied, substring s[start:] is processed. If optionai arguments start and end 
are suppiied, substring s[start:end] is processed. 

• (3) Default encoding is sys . getdef aultencoding (), can be changed via sys . setdefaultencoding () . Optionai 
argument errors may be given to set a different error handiing scheme. The default for errors is 'striet', 
meaning that encoding errors raise a ValueError. Other possible values are 'ignore' and 'replace'. See also 
module codecs. 

• (4) If optionai argument tabsize is not given, a tab size of 8 characters is assumed. 

• (5) Returns False if string s does not contain at least one character. 

• (6) Returns False if string s does not contain at least one cased character. 

• (7) A titiecased string is a string in which uppercase characters may oniy follow uncased characters and 
lowercase characters onIy cased ones. 

• (8) s is returned if width is less than len(s). 

• (9) If the optionai argument maxCount is given, oniy the first maxCount occurrences are replaced. 

• (10) If separator is not specified or None, any whitespace string is a separator. If maxsplit is given, at most 
maxsplit splits are done. 

• (11) Line breaks are not included in the resulting list uniess keepends is given and true. 

• (12) table must be a string of length 256. 

String formatting with the % operator 

formatString °/o args —> evaluates to a string 

• formatString mixes normal text with C printf format fields : 

°/o[flag] [ width][.precision] formatCode 

where formatCode is one of c, s, i, d, u, o, x, X, e. E, f, g, G, r, % (see table below). 

• The flag characters -, +, blank, # and 0 are understood (see table below). 

• Width and precision may be a * to specify that an integer argument gives the actual width or precision. 


E xamples of width and precision : 


Examples 

Format string 

Resuit 

'%3d' % 2 

' 2 ’ 

'%*d' % (3, 2) 

' 2 ' 

'%-3d' % 2 

'2 ' 

'%03d' % 2 

'002' 

'% d' % 2 

' 2 ' 

'%+d' % 2 

'+2' 

'%+3d' % -2 

' -2 ' 

'%- 5d' % 2 

' 2 ' 

'%.4f ' % 2 

'2.0000' 

% (4, 2) 

'2.0000' 

'%0*.*f’ % (10, 4, 2) 

'00002.0000' 

'%10.4f' % 2 

' 2.0000' 

'%010.4f' % 2 

'00002.0000' 
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• %s will convert any type argument to string (uses str() function) 

• args may be a singie arg or a tuple of args 

'%s has %03d quote types.' % ('Python', 2) == 'Python has 002 quote types.' 

• Right-hand-side can also be a mapping: 

a = '%(lang)s has %(c)03d quote types.' % {'c':2, 'langPython'} 

(vars 0 function very handy to use on right-hand-side) 


Format codes 

Code 

Meaning 

d 

Signed integer decimal. 

i 

Signed integer decimal. 

0 

Unsigned octal. 

u 

Unsigned decimal. 

X 

Unsigned hexadecimal (lowercase). 

X 

Unsigned hexadecimal (uppercase). 

e 

Floating point exponentiai format (lowercase). 

E 

Floating point exponentiai format (uppercase). 

f 

Floating point decimal format. 

F 

Floating point decimal format. 

g 

Same as "e" if exponent is greater than -4 or less than precision, "f" otherwise. 

G 

Same as "E" if exponent is greater than -4 or less than precision, "F" otherwise. 

C 

Singie character (accepts integer or singie character string). 

r 

String (converts any python object using repr o ). 

s 

String (converts any python object using stro). 

% 

No argument is converted, results in a "%" character in the resuit. (The complete specification is % 

%.) 


Conversion flag characters 

Flag 

Meaning 

# 

The value conversion will use the "alternate form". 

0 

The conversion will be zero padded. 

- 

The converted value is left adiusted (overrides "-"). 


(a space) A blank shouid be left before a positive number (or empty string) produced by a signed 
conversion. 

+ 

A sign character ("+" or "-") will precede the conversion (overrides a "space" flag). 


String templatlng 

Since 2.4 [PEP 292] the string module provides a new mechanism to substitute variables into template strings. 
Variables to be substituted begin with a $. Actual values are provided in a dictionary via the substitute or 
safe_substitute methods (substitute throws KeyError if a key is missing while safe_substitute ignores it) : 

t = string.Template('Helio $name, you won $$$amount') # (note $$ to literalize $) 
t.substitute({'name': 'Eric', 'amount': 100000}) # -> u'Hello Eric, you won $100000' 

String formatting with format() 

Since 2.6 [PEP 3101] string formatting can also be done with the format () method: 

"string-to-format".format(args) 

Format fields are specified in the string, surrounded by {}, while actual values are args to format () : 

{field [! con version ] [: format_spec ]} 

• Each field refers to an arg either by its position (>=0), or by its name if it's a keyword argument. The same arg 
can be referenced more than once. 

• The conversion can be !s or !r to call str o or repr o on the field before formatting. 

• The format_spec takes the following form: 

[[/7//]a//gn] [sign][#][0][width][.precision][type] 

o The align flag Controls the alignment when padding values (see table below), and can be preceded by a 
fiii character. A fili cannot be used on its own. 
o The sign flag Controls the display of signs on numbers (see table below). 
o The # flag adds a leading Ob, Oo, or Ox for binary, octal, and hex conversions. 
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o The 0 flag zero-pads numbers, equivalent to having a fill-align of 0=. 

o The width is a number giving the minimum field width. Padding will be added according to align untii this 
width is achieved. 

o For floating-point conversions, precision gives the number of places to display after the decimal point. For 
non-numeric conversion, precision gives the maximum field width. 
o The type specifies how to present numeric types (see tables below). 


• Braces can be doubled ({( or }}) to insert a literal brace character. 


Alignment flag characters 

Flag 

Meaning 

< 

Left-aligns the field and pads to the riqht (default for non-numbers) 

> 

Riqht-aliqns the field and pads to the left (default for numbers) 

= 

Inserts paddinq between the siqn and the field (numbers oniy) 

/\ 

Aliqns the field to the center and pads both sides 


Sign flag characters 

Flag 

Meaning 

+ 

Displays a siqn for ali numbers 

- 

Displays a siqn for neqative numbers oniy (default) 


(a space) Displays a sign for negative numbers and a space for positive numbers 


Integer type flags 

Flag 

Meaning 

b 

Binary format (base 2) 

c 

Character (interprets integer as a Unicode code point) 

d 

Decimal format (base 10) (default) 

0 

Octal format (base 8) 

X 

Hexadecimal format (base 16) (lowercase) 

X 

Hexadecimal format (base 16) (uppercase) 


Floating-point type flags 

Flag 

Meaning 

e 

ExponentiaI format (lowercase) 

E 

ExponentiaI format (uppercase) 

f 

Fixed-point format 

F 

Fixed-point format (same as "f") 

q 

General format - same as "e" if exponent is qreater than -4 or less than precision, "f" otherwise. (default) 

G 

General format - Same as "E" if exponent is qreater than -4 or less than precision, "F" otherwise. 

n 

Number format - Same as "q", except it uses locale settinqs for separators. 

% 

Percentaqe - Multiplies by 100 and displays as "f", followed by a percent siqn. 


File objects 

(Type file). Created with built-in functions open() [preferred] or its alias fiie() . May be created by other modules' 
functions as well. 

Unicode file names are now supported for ali functions accepting or returning file names (open, os.listdir, etc...). 


Operators on file objects 


File operations 

Operation 

Resuit 

f.closeO 

Close file f. 

f.filenoO 

Get fileno (fd) for file f. 

f.flushO 

Flush file fs internal buffer. 

f.isattyO 

1 if file fis connected to a tty-like dev, eise 0. 

f.nextO 

Returns the next input line of file f, or raises stopiteration when EOF is hit. 
Files are their own iterators. next is implicitiy called by constructs like for 

line in f: print line. 

f.read ([s/ze]) 

Read at most size bytes from file f and return as a string object. If s/ze 
omitted, read to EOF. 

f.readIineO 

Read one entire line from file f. The returned line has a trailing \n, except 
possibly at EOF. Return " on EOF. 

f.readIinesO 

Read untii EOF with readIineO and return a list of lines read. 

f.xreadIinesO 

Return a sequence-like object for reading a file line-by-line without reading the 
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entire file into memory. From 2.2, use rather: for line in f (see below). 

for line in f: do somethinq... 

Iterate over the lines of a file (usinq readiine) 

f.seek(o/fsef[, whence=0'\) 

Set file fs position, like "stdio's fseek()". 
whence == 0 then use absolute indexing. 
whence == 1 then offset relative to current pos. 
whence == 2 then offset relative to file end. 

f.tellO 

Return file fs current position (byte offset). 

f.truncate([s/ze]) 

Truncate fs size. If s/ze is present, f is truncated to (at most) that size, 
otherwise f is truncated at current position (which remains unchanged). 

f.write(sfr) 

Write strinq to file f. 

f.writelines(//sf) 

Write list of strings to file f. No EOL are added. 


File Exceptions 

EOFError 

End-of-file hit when reading (may be raised many times, e.g. if f is a tty). 

lOError 

Other I/O-related I/O operatiori failure 


Sets 

Since 2.4, Python has 2 new built-in types with fast C implementations [PEP 218]: set and frozenset (immutable 
set). Sets are unordered collections of unique (non duplicate) elements. Elements must be hashable. frozensets are 
hashable (thus can be elements of other sets) while sets are not. AII sets are iterable. 


Since 2.3, the classes set and immutabieset were available in the module sets.This module remains in the 2.4 std 
li brary in addition to the built-in types. _ 


Main Set operations 

Operation 

Resuit 

set/frozenset([/ferab/e=None]) 

[using built-in types] Builds a set or frozenset from the given 
iterable (default: empty), e.g. set ([1,2,3]), set ("heiio"). 

Set/ImmutableSet([/ferab/e=None]) 

[using the sets module] Builds a set or immutabieset from the 
given iterable (default: empty), e.g. set ([i, 2,3]) . 

len(s) 

Cardinality of set s. 

elt in s / not in s 

True if element elt belongs / does not belong to set s. 

for elt in s: process elt... 

Iterates on elements of set s. 

sl .issubset(s2) 

True if every element in sl is in iterable s2. 

sl .issuperset(s2) 

True if every element in s2 is in iterable sl. 

s.add(e/f) 

Adds element elt to set s (if it doesn't aiready exist). 

s.remove(e/f) 

Removes element elt from set s. KeyError if element not found. 

s.discard(e/f) 

Removes element elt from set s if present. 

s.popO 

Removes and returns an arbitrary element from set s; raises 

KeyError if empty. 

s.clearO 

Removes all elements from this set (not on immutable sets!). 

sl.intersection(s2[, s3...]) orsl8is2 

Returns a new Set with elements common to all sets (in the 
method s2, s3,... can be any iterable). 

sl .union(s2[, s3...]) or sl \s2 

Returns a new Set with elements from either set (in the method 
s2, s3,... can be any iterable). 

sl.difference(s2[, s3...]) orsl-s2 

Returns a new Set with elements in sl but not in any of s2, s3 ... 

(in the method s2, s3,... can be any iterable) 

sl .symmetric difference(s2) or sl''s2 

Returns a new Set with elements in either sl or s2 but not both. 

s.copyO 

Returns a shallow copy of set s. 

s.update(/ferab/eir, iterable2...]) 

Adds all values from all given iterables to set s. 


Named Tuples 

Python 2.6 module collections introduces the namedtuple datatype. The factory function namedtuple (typename, 
fieidnames) creates subclasses of tupie whose fields are accessible by name as well as index: 


# Create a named tupie class 'person': 

person = collections.namedtuple{'person', 'name firstName age') # field names separated by space or comma 
assert issubclass(person, tupie) 

assert person._fields == {'name', 'firstName', 'age') 
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# Create an instance of person: 
jdoe = person('Doe', 'John', 30) 

assert str(jdoe) == "person(name='Doe', firstName='John', age=30)" 

assert jdoe[0] == jdoe.name == 'Doe' # access by index or name is equivalent 

assert jdoe[2] == jdoe.age == 30 

# Convert instance to dict: 

assert jdoe._asdict() == {'age': 30, 'name': 'Doe', 'firstName': 'John'} 

# Although tuples are normally immutable, one can change field values via _replace(): 
jdoe._replace(age=25, firstName='Jane') 

assert str(jdoe) == "person{name='Doe', firstName='Jane', age=25)" 


Date/Time 

Python has no intrinsic Date and Time types, but provides 2 buiit-in moduies: 

• time: time access and conversions 

• datetime: ciasses date, time, datetime, timedelta, tzinfo. 

See aiso the third-party moduie: mxDateiime. 


Advanced Types 

- See manuais for more detaiis - 

• Module objects 

• Class objects 

• Class instance objects 

• Type objects (see module: types) 

• File objects (see above) 

• Sllce objects 

• Ellipsis object, used by extended slice notation (unique, named Ellipsis) 

• Null object (unique, named None) 

• XRange objects 

• Callable types: 

o User-defined (written in Python): 

■ User-defined Function objects 

■ User-defined Method objects 
o Built-in (written in C): 

■ Built-in Function objects 

■ Built-in Method object 

• Internal Types: 

o Code objects (byte-compile executable Python code: bytecode) 
o Frame objects (execution frames) 
o Traceback objects (stack trace of an exception) 


Statements 


Statement 

Resuit 

pass 

Null statement 

dei name[, name]* 

Unbind name(s) from object. Object will be indirectiy (and 
automatically) deleted oniy if no longer referenced. 

print[>> fileobject,] [si [, s2 ]* [,] 

Writes to sys.stdout, or to fileobject if supplied. Puts spaces 
between arguments. Puts newline at end uniess statement 
ends with comma [if nothing is printed when using a comma, 
try calling system. out. fiush 0 ]. Print is not required when 
running interactively, simply typing an expression will print its 
value, uniess the value is None. 

exec X [in globais [, locais]] 

Executes x in namespaces provided. Defaults to current 
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namespaces. x can be a string, open file-like object or a 
function object. locais can be any mapping type, not onIy a 
regular Python dict. See also built-in function execfiie. 

callable{value,... [id=value] , [*args], [**/fw]) 

Call function callable with parameters. Parameters can be 
passed by name or be omitted if function defines default 
values. E.g. \f callable is defined as "def caiiabie {pi=i, 

p2=2)" 

"callableQ" < = > ’'callable{l, 2)" 

"callablellO)" < = > ''callable{10, 2)" 

"ca//a£)/e(p2=99)" < = > "ca//aWe(l, 99)" 

*args is a tuple of positional arguments. 

**kw is a dictionary of keyword arguments. 


Assignment operators 


Assignment operators 

Operator 

Resuit 

Notes 

a = b 

Basic assignment - assiqn object b to label a 

(1)(2) 

a += b 

Rouqhly equivalent to a = a + b 

(3) 

a -= b 

Rouqhly equivalent to a = a - b 

(3) 

a *= b 

Rouqhly equivalent to a = a * b 

(3) 

a != b 

Rouqhly equivalent to a = a / b 

(3) 

a //= b 

Rouqhly equivalent to a = a // b 

(3) 

a %= b 

Rouqhly equivalent to a = a % b 

(3) 

a **= b 

Rouqhly equivalent to a = a ** b 

(3) 

a 8 l = b 

Rouqhly equivalent to a = a & b 

(3) 

a \= b 

Rouqhly equivalent to a = a 1 b 

(3) 

a ''= b 

Rouqhly equivalent to a = a ^ b 

(3) 

a »= b 

Rouqhly equivalent to a = a >> b 

(3) 

a «= b 

Rouqhly equivalent to a = a << b 

(3) 


Notes : 

• (1) Can unpack tuples, lists, and strings: 

first, second = 1[0:2] # equivalent to: first=l[0]; second=l[l] 

[f, s] = range(2) # equivalent to: f=0; s=l 

cl,c2,c3 = 'abc' # equivalent to: cl='a'; c2='b'; c3='c' 

(a, b), c, (d, e, f) = [’ab’, ’c’, ’def’] # equivalent to: a='a’; b='b’; c='c’; d='d'; e='e'; 

f-'f' 

Tip: X, y = y, X swaps X and /. 

• (2) Multiple assignment possible: 

a ^ b ^ C ^ 0 

listi = list2 = [1, 2, 3] # listi and list2 points to the same list (11 is 12) 

• (3) Not exactiy equivalent - a is evaluated oniy once. Also, where possible, operation performed in-place - a is 
modified rather than replaced. 


Conditional Expressions 

Conditional Expressions (not statements) have been added since 2.5 [PEP 308]: 

resuit = (whenTrue if condition else whenFalse) 

is equivalent to: 

if condition: 

resuit = whenTrue 

else: 

resuit = whenFalse 

0 are not mandatory but recommended. 

ControI Flow statements 
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ControI flow statements 


Statement 

Resuit 

if condition: 
suite 

[elif condition: suite]* 

[eise: 

suite] 

Usual if/else if/else statement. See also Conditional Expressions. 

while condition: 
suite 

[eIse: 

suite] 

Usual while statement. The eise suite is executed after loop exits, uniess the 
lOOp is exited with break. 

for eiement in sequence: 
suite 

[eise: 

suite] 

Iterates over sequence, assigning each eiement to eiement. Use built-in range 
function to iterate a number of times. The eise suite is executed at end uniess 
loop exited with break. 

break 

Immediately exits for or whiie loop. 

continue 

Immediately does next iteration of for or while loop. 

return [resuit] 

Exits from function (or method) and returns resuit (use a tuple to return more 
than one value). If no resuit given, then returns None. 

yield expression 

(Oniy used within the body of a generator function, outside a try of a 
try. .finaiiy). "Returns" the evaluated expression. 


Exception statements 


Exception statements 

statement 

Resuit 

assert expr[, message] 

expr is evaluated. if false, raises exception AssertionError with 
message. Before 2.3, inhibited if debug is 0. 

try: 

biockl 

[except [exception [, vaiue]]: 
handier] + 

[except [exception [as vaiue]]: 
handier] + 

[eise: 

eise-block] 

Statements in biockl are executed. If an exception occurs, look 
in except clause(s) for matching exception(s). If matches or bare 
except, execute handier of that clause. If no exception happens, 
eise-block in eise clause is executed after biockl. If exception 
has a vaiue, it is put in variable vaiue. exception can also be a 
tuple of exceptions, e.g. except (KeyError, NameError) , e: 
print e. 

2.6 also supports the keyword as instead of a comma between 
the exception and the vaiue, which will become a mandatory 
change in Python 3.0 [PEP3110]. 

try: 

biockl 

finaiiy: 

finai-biock 

Statements in biockl are executed. If no exception, execute 
finai-biock (even if biockl is exited with a return, break or 
continue Statement). If exception did occur, execute finai-biock 
and then immediately re-raise exception. Typically used to ensure 
that a resource (file, lock...) allocated before the try is freed (in 
the finai-biock) whatever the outcome of biockl execution. 

See also the with statement below. 

try: 

biockl 

[except [exception [, vaiue]]: 
handlerl] + 

[except [exception [as vaiue]]: 
handler] + 

[eise: 

eise-block] 

finaiiy: 

finai-biock 

Unified try/except/finally. Equivalent to a try.. .except nested 
inside a try. .finaiiy [PEP341]. See also the with statement 
below. 

with allocate-expression [as variable] 
with-block 

Alternative to the try. . . finaiiy structure [PEP343]. 
allocate-expression shouid evaluate to an object that supports 
the context management protocoi, representing a resource. This 
object may return a vaiue that can optionally be bound to 
variable (variable is not assigned the resuit of expression). 

The object can then run set-up code before with-biock is 
executed and some clean-up code is executed after the block is 
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done, even if the block raised an exception. 

Standard Python objects such as files and locks support the 
context management protocoi: 

with open('/etc/passwd', 'r') as f: # file automatically closed on 
block exit 
for line in f: 
print line 

with threading.Lock(): # lock automatically released on block exit 
do something... 

- You can write your own context managers. 

- Helper functions are available in module contextiib. 

In 2.5 the statement must be enabled by: from _future_ 

import with_statement. The Statement is always enabled 
starting in Python 2.6. 


raise exceptioninstance 

Raises an instance of a class derived from BaseException 
(preferred form of raise). 

raise exceptionClass [, value [, traceback]] 

Raises exception of given class exceptionClass with optional value 
value. Arg traceback specifies a traceback object to use when 
printing the exception's backtrace. 

raise 

A raise statement without arguments re-raises the last exception 
raised in the current function. 


• An exception is an instance of an exception class (before 2.0, it may also be a mere string). 

• Exception classes must be derived from the predefined class: Exception, e.g.: 

class TextException(Exception): pass 

try: 

if bad: 

raise TextException () 
except Exception: 

print 'Oops' # This will be printed because TextException is a subclass of Exception 

• When an error message is printed for an unhandied exception, the class name is printed, then a colon and a 
space, and finally the instance converted to a string using the built-in function str o . 

• AII built-in exception classes derives from standardError, itself derived from Exception. 

• [PEP 352]: Exceptions can now be new-style classes, and ali built-in ones are. Built-in exception hierarchy 
slightiy reorganized with the introduction of base class BaseException. Raising strings as exceptions is now 
deprecated (warning). 

Name Space Statements 

Imported module files must be located in a directory listed in the Python path (sys.path). Since 2.3, they may reside 
in a zip file [e.g. sys.path.insert(0, "aZipFile.zip")]. 

Absolute/relative imports (since 2.5 [PEP328]): 

• Feature must be enabled by: from _future_ import absoiute_import: will probably be adopted in 2.7. 

• Imports are normally relative-, modules are searched first in the current directory/package, and then in the 
builtin modules, resulting in possible ambiguities (e.g. masking a builtin Symbol). 

• When the new feature is enabled: 

o import X will look up for module X in sys.path first {absolute import). 

o import .X (with a dot) will stili search for X in the current package first, then in builtins {relative import). 
o import . .X will search for X in the package containing the current one, etc... 

Packages (>1.5): a package is a name space which maps to a directory including module(s) and the speciai 
initialization module _init_.py (possibly empty). 

Packages/directories can be nested. You address a module's Symbol via [package. [package...] .module.symboi. 
[1.51: On Mac & Windows, the case of module file names must now match the case as used in the import statement] 


Name space statements 

Statement 

Resuit 

import modu/el [as namel] 

Imports modules. Members of module must be referred to by qualifying with 

[, module2]* 

[package.]module name, e.g.: 


import sys; print sys.argv 
import packagel.subpackage.module 
packagel.subpackage.module.foo() 
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modulel renamed as namel, if supplied. 


from module import namel 
[as othernamel][, name2]* 

Imports names from module module in current namespace. 

from sys import argv; print argv 

from packagel import module; module.foo () 

from packagel.module import foo; foo() 

namel renamed as othernamel, if supplied. 

[2.4] You can now put parentheses around the list of names in a from module 
import names statement (PEP 328). 

from module import * 

Imports all names in module, except those starting with Use sparsely, 

beware of name clashes! 

from sys import *; print argv 

from package.module import *; print x 

Oniy legal at the top level of a module. 

If module defines an_ aii _attribute, oniy names listed in_ aii _will be 

imported. 

NB: "from package import *" onIy imports the symbois defined in the 
package's_ init_.py file, not those in the package's modules I 

global namel [, name2] 

Names are from global scope (usually meaning from module) rather than local 
(usually meaning oniy in function). 

E.g. in function without global statements, assuming "x" is name that hasn't 
been used in function or module so far: 

- Try to read from "x" -> NameError 

- Try to write to "x" -> creates "x" local to function 

If "x" not defined in fct, but is in module, then: - Try to read from "x", gets value 
from module 

- Try to write to "x", creates "x" local to fct 

But note "x[0] = 3" starts with search for "x", will use to global "x" if no local "x". 


Function Definitiori 


def funcName ( [paramList]) : 
suite 

Creates a function object and binds it to name funcName. 

paramList ::= [param [, param]*] 
param value \ id=value I *id I **id 

• Args are passed by value, so oniy args representing a mutable object can be modified (are inout parameters). 

• Use return to return (None) from the function, or retum value to return value. Use a tuple to return more 
than one value, e.g. return 1 , 2,3 

• Keyword arguments arg=vaiue specify a default value (evaluated at function def. time). They can onIy appear 
last in the param list, e.g. foo (x, y=i, s=’’). 

• Pseudo-arg *args captures a tuple of all remaining non-keyword args passed to the function, e.g. if def foo (x, 
*args) : .. . is called f 00 (1, 2, 3), then args will contain (2,3). 

• Pseudo-arg **/cwargs captures a dictionary of all extra keyword arguments, e.g. if def foo(x, **kwargs) : 

... is called foo (1, y=2, z=3), then /cwargs will contain ('y':2, 'z’:3}.ifdef foo(x, *args, **kwargs) : 
... is called foo (1, 2 , 3 , y=4, z=5), then args will contain (2, 3), and kwargs will contain {'y':4, ’z':5} 

• args and kwargs are conventional names, but other names may be used as well. 

• *args and **kwargs can be "forwarded" (individually or together) to another function, e.g. 
def fl (x, *args, **kwargs): 

f2(*args, **kwargs) 

Since 2.6, **kwargs can be any mapping, not oniy a dict. 

• See also Anonymous functions {lambdas). 

Class Definition 

class className [ ( super_classl [, super_class 2 ]*)]: 
suite 

Creates a class object and assigns it name className. 

suite may contain local "defs" of class methods and assignments to class attributes. 


Examples: 
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class MyClass (classi, class2) : ... 

Creates a class object inheriting from both classi and class2. Assigns new class object to name Myciass. 


class MyClass: . . . 

Creates a base class object (inheriting from nothing). Assigns new class object to name Myciass. Since 2.5 the 
equivalent syntax class Myciass (): ... is allowed. 


class MyClass (object): ... 

Creates a new-style class (inheriting from object makes a class a new-style class -available since Python 2.2-). 
Assigns new class object to name Myciass. 

• First arg to class instance methods (operations) is always the target instance object, called 'self' by convention. 

• SpeciaI static method_ new _(c/s[,...]) called when instance is created. Ist arg is a class, others are args to 

_init_0, more detaiis here 

• SpeciaI method_ init _() is called when instance is created. 

• SpeciaI method_ dei () called when no more reference to object. 

• Create instance by "calling" class object, possibly with arg (thus instance=apply(aClassObject, args...) creates 
an instance!) 

• Before 2.2 it was not possible to subclass built-in classes like list, dict (you had to "wrap" them, using UserDict 
& UserList modules); since 2.2 you can subclass them directiy (see Types/Classes unification). 

Example : 

class c (c_parent): 

def _ _init_(self, name): 

self.name = name 
def print_name(self ): 

print "I'm", self.name 
def call_parent(self ): 

c_parent.print_name(self) 


instance = c('tom') 
print instance.name 
'tom' 

instance.print_name() 
"I'm tom" 


Call parenfs super class by accessing parenfs method directiy and passing self explicitiy (see caii_parent in 
example above). 

Many other speciaI methods available for implementing arithmetic operators, sequence, mapping indexing, etc... 

Types / classes unification 

Base types int, fioat, str, iist, tupie, dict and file now (2.2) behave like classes derived from base class 
object, and may be subclassed: 

X = int (2) # built-in cast function now a constructor for base type 

y = 3 # <=> int (3) (litterals are instances of new base types) 

print type(x), type(y) # int, int 

assert isinstance (x, int) # replaces isinstance (x, types.IntType) 

assert issubclass (int, object) # base types derive from base class 'object'. 

s ^ "hello" # <^> str("hello") 

assert isinstance (s, str) 

f - 2.3 # <-> fioat (2.3) 

class Mylnt(int): pass # may subclass base types 
x,y = Mylnt(l), Mylnt("2") 
print X, y, x+y # => 1,2,3 
class MyList (list): pass 
1 = MyList("hello") 

print 1 # ['h', 'e', '1', '1', 'o'] 

New-style classes extends object. Old-style classes don't. 

Documentation Strings 

Modules, classes and functions may be documented by placing a string literal by itself as the first statement in the 
suite. The documentation can be retrieved by getting the ' _doc_ ' attribute from the module, class or function. 

Example : 

class C: 

"A description of C" 

def _init_(self): 
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"A descriptiori of the constructor" 

# etc. 

c._doc_ == "A descriptior of C". 

c._init_._doc_ == "A descriptiori of the constructor" 


Iterators 

• An iterator enumerates elements of a collectiori. It is an object with a singie method next () returning the next 
element or raising stopiteration. 

• You get an iterator on obj via the new built-in function iter (obj), which caiis obj. _ciass_._iter_o . 

• A coiiection may be its own iterator by impiementing both_iter_o and next (). 

• Built-in coiiections (iists, tupies, strings, dict) impiement_iter_o ; dictionaries (maps) enumerate their 

keys; fiies enumerates their iines. 

• You can buiid a list or a tupie from an iterator, e.g. list (aniterator) 

• Python impiicitiy uses iterators wherever it has to loop : 

O for elt in coiiection: 

O if elt in coiiection: 

O when assigning tupies: X, y, z= coiiection 

Generators 

• A generator is a function that retains its state between 2 caiis and produces a new vaiue at each invocation. 
The vaiues are returned (one at a time) using the keyword yieid, whiie retum or raise stopiteration o are 
used to notify the end of vaiues. 

• A typicai use is the production of IDs, names, or seriai numbers. Fancier appiications iike nanothreads are aiso 
possibie. 

• In 2.2, the feature needs to be enabled by the statement: from _future_ import generators (not 

required since 2.3+) 

• To use a generator: caii the generator function to get a generator object, then caii generator .next o to get 
the next vaiue untii stopiteration is raised. 

• 2.4 introduces generator expressions [PEP 289] simiiar to iist comprehensions, except that they create a 
generator that wiii return eiements one by one, which is suitabie for iong sequences : 

linkGenerator = (link for link in get_all_links() if not link.followed) 
for link in linkGenerator: 

...process link... 

Generator expressions must appear between parentheses. 

• [PEP342] Generators before 2.5 couid oniy produce output. Now vaiues can be passed to generators via their 
method send(vaiue). yieid is now an expression returning a vaiue, so vai = (yieid i) wiii yieid i to the 
caiier, and wiii reciprocaiiy evaiuate to the vaiue "sent" back by the caiier, or None. 

Two other new generator methods aiiow for additionai controi: 

o throw(type, vaiue=None, traceback=None) is used to raise an exception inside the generator (appears 
as raised by the yieid expression). 

o ciose 0 raises a new GeneratorExit exception inside the generator to terminate the iteration. 

• Since 2.6 Generator objects have a gi_code attribute that refers to the originai code object backing the 
generator. 

Exampie : 

def genID(initialValue=0): 

V = initialValue 
whiie V < initialValue + 1000: 
yieid "ID_%05d" % v 

V 1 

return # or: raise Stopiteration() 
generator = genID() # Create a generator 
for i in range(lO): # Generates 10 vaiues 
print generator.next() 

Descriptors / Attribute access 

• Descriptors are objects impiementing at ieast the first of these 3 methods representing the descriptor protocoi: 

o get (self, obj, type=None) —> vaiue 

O set (self, obj, vaiue) 

O _delete_(self, obj) 

Python now transparentiy uses descriptors to describe and access the attributes and methods of new-styie 
ciasses (i.e. derived from object). ) 
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• Built-in descriptors now allow to define: 

o Static methods : Use staticmethod (f) to make method f (x) static (unbound). 

o Class methods: like a static but takes the Class as Ist argument => Use f = ciassmethod(f) to make 
method f (theciass, x) a class method. 

o Properties : A property is an instance of the new built-in type property, which implements the 
descr/ptor protocoi for attributes = > Use propertyWame = property (fget=None, fset=None, 
fdei=None, doc=None) to define a property inside or outside a class. Then access it as propertyName or 
obj .propertyName. 

Since 2.6, the new decorators @prop.getter, @prop.setter, and @prop.deieter add functions to an 
existing property: 

class C(object): 

Qproperty # (since Python 2.4) 
def X(self): 

return self._x 

@x.setter 

def x(self, value): 
self._x = value 

@x.deieter 
def X(self) : 

dei self._x 

o SIots. New style classes can define a class attribute_siots_to constrain the list of assignable 

attribute names, to avoid typos (which is normally not detected by Python and leads to the creation of 
new attributes), e.g._siots_= ('x', 'y') 

Note : According to recent discussions, the real purpose of siots seems stili unclear (optimization?), and 
their use shouid probably be discouraged. 

Decorators for functions, methods & classes 

• [PEP 318] A decorator D is noted @d on the line preceding the function/method it decorates : 

@D 

def f(): ... 

and is equivalent to: 
def f(): ... 

f = D(f) 

• Several decorators can be applied in Cascade : 

@A 

@B 

@c 

def f(): ... 

is equivalent to: 

f = A(B(C(f))) 

• A decorator is just a function taking the fct to be decorated and returns the same function or some new callable 
thing. 

• Decorator functions can take arguments: 

@A 

@B 

@C (args) 
becomes : 

def f(): ... 

_deco = C(args) 
f = A (B (_deco (f) ) ) 

• The decorators @staticmethod and @ciassmethod replace more elegantly the equivalent declarations f = 
staticmethod(f) and f = ciassmethod(f) . 

• [PEP 3129] Decorators may also be applied to classes: 

@D 

class C(): ... 

is equivalent to: 

class C(): ... 

C = D(C) 


M isc 


lambda [param_list]: returnedExpr 

Creates an anonymous function. 
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returnedExpr must be an expression, not a statement (e.g., not "if xx:...", "print xxx", etc.) and thus can't contain newlines. 
Used mostly for filter(), map(), reduce() functions, and GUI callbacks. 


List comprehensions 

resuit - [expression for iteml in sequencel fif conditioni] 

[for item 2 in sequence 2 ... for itemN in sequenceN] 

] 

is equivalent to: 

resuit = [] 

for iteml in sequencel: 

for item 2 in sequence 2 : 

for itemN in sequenceN: 

if {conditioni) and further conditions: 
resuit. append ( expression) 

See also Generator expressions. 


Nested scopes 

Since 2.2 nested scopes no longer need to be specially enabled by a from _future_ import nested_scopes directive, and 

are always used. 


Built-In Functions 


Built-in functions are defined in a module buiitin automatically imported. 


Built-In Functions 

Function 

Resuit 

_ import _ {name[, 

globals[,locals[,from 

list]]]) 

Imports module within the given context (see library reference for more detaiis) 

abs(x) 

Returns the absolute value of the number x. 

a\\{iterable) 

Returns True if booi (x) Is xrue for all values x in the iterable. 

any{iterable) 

Returns True if booi (x) is True for any value x In the Iterable. 

apply(f, args[, 
keywords]) 

Calis func/method fwith arguments args and optional keywords. deprecated since 2.3, 
replace apply (fune, args, keywords) with func(*args, **keywords) [detaiIs] 

basestringO 

Abstract superclass of str and Unicode; can't be called or instantiated directly, but 
usefulin: isinstance (obj , basestring) . 

bin(x) 

Converts a number to a binary strinq. 

bool([x]) 

Converts a value to a Boolean, using the Standard truth testlng procedure. If x Is false 
or omitted, returns False; otherwise returns True. booi Is also a class/type, subclass of 
int. Class booi cannot be subclassed further. Its oniy instances are False and True. 

See also boolean operators 

buffer{object[, offset[, 
size]]) 

Returns a Buffer from a slice of object, which must support the buffer call interface 
(strinq, array, buffer). Non essentia! function, see (detailsl 

bytearray(/fera£>/e) 

bytearray(/engf/7) 

Constructs a mutable sequence of bytes. This type supports many of the same 
operatlons avallable In strs and iists. The latter form sets the size and initializes to all 
zero bytes. 

bytesCofyecf) 

Constructs an 8-bit strinq representation of an object. Equivalent to str for now, but 
thIs can be used to explicitiy Indicate strinqs which shouid not be Unicode when 
convertinq to Python 3.0 rPEP31121 

callable(x) 

Returns True if x callable, eise False. 

chrC/") 

Returns one-character strinq whose ASCII code is integer /. 

classmethod 

(function) 

Returns a class method for function. A class method receives the class as Implicit first 
arqument, just llke an instance method receives the Instance. To declare a class 
method, use this Idiom: 

class C: 

def f(cls, argl, arg2, ...): ... 

f = classmethod( f ) 

Then call It on the class c . f () or on an Instance c () . f (). The Instance is ignored 
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except for its class. If a class method is called for a derived class, the derived class 
object is passed as the implied first argument. 

Since 2.4 you can alternatively use the decorator notatiori: 
class C: 

@classinethod 

def f(cls, argl, arg2, ...): ... 

cmp(x,K) 

Returns negative, 0, positive if x <, = = , > to y respectively. 

coerce(x,y) 

Returns a tuple of the two numeric arguments converted to a common type. Non 
essentia! function, see [detaiis] 

comp\\e{string, 
filename, kind[, flagsf, 
dont_inherit]]) 

Compiles string into a code ohject. filename is used in error message, can he any 
string. It is usually the file from which the code was read, or e.g. ’<string>’ if not 
read from file, kind can he 'eval' If string Is a singie stmt, or 'singie' which prints the 
output of expression statements that evaluate to something eise than None, or he 
'exec'. New args flags and dontjnherit concern future statements. Since 2.6 the fct 
accepts keyword arguments as well as positional parameters. 

complex(rea/[, 

imageY) 

Creates a complex ohject (can also he done using J or j sufflx, e.g. i+3j). Since 2.6, 
also accepts strings, with or without parenthesis, e.g. complex (' i+3J' ) or complex 
(’ (1+3J) ’) . 

delattr(oby, name) 

Deletes the attrihute named name of ohject obj < = > dei obj .name 

d i ct ([ mapp/ng - or- 
sequencej) 

Returns a new dictionary Initialized from the optional argument (or an empty dictionary 

If no argument). Argument may he a sequence (or anything iterahie) of palrs 
(key,value). 

dir([oP 7 ecf]) 

Without args, returns the list of names in the current local symhol tahie. With a 
module, class or class instance ohject as arg, returns the llst of names In its attr. 
dictionary. Since 2.6 object can override the std implementation via speciai method 

_dir_() . 

divmod(a,t)) 

Returns tuple (a//b, a%b) 

enumerate(/fera£)/e) 

Iterator returning pairs (Index, value) of iterable, e.g. List (enumerate ( 'Py' )) -> 

[(0, 'P'), (1, 'y')]. 

eval(s[, globals[, 
loca Is]]) 

Evaluates string s, representing a singie python expression, In (optional) globais, locais 
contexts. s must have no NUL's or newllnes. s can also he a code ohject. locais can he 
any mapping type, not oniy a regular Python dict. 

Examole: 

X = 1; assert eval('x + 1') == 2 

(To execute statements rather than a singie expression, use Python statement exec or 
huilt-ln function execfiie) 

execfile(/7/e[, globais 
[Jocais]]) 

Executes a file without creating a new module, unilke import. locais can he any 
mapping type, not onIy a regular Python dIct. 


Opens a file and returns a new fiie ohject. Alias for open. 


Constructs a list from those elements of sequence for which function returns true. 
function takes one parameter. 

float(x) 

Converts a numher or a string to floating point. Since 2.6, x can he one of the strings 
’ nan ’ , ' linf ' , or ’ -inf ’ to represent respectively IEEE 754 Not A Numher, positive 
and negative Infinity. Use module math fcts isnan o and isinf o to check for NAN or 
Infinity. 

format(va/ue[, 

format_spec]) 

Formats an ohject with the given specification (default ") hy calling its_ format_ 

method. 

frozenset([/fera£)/e]) 

Returns a frozenset (immutahie set) ohject whose (immutahie) elements are taken 
from iterable, or empty hy default. See also Sets. 

getattr{object,name 

[,default])) 

Gets attrihute called name from object, e.g. getattr(x, 'f') < = > x.f). If not found, ralses 
AttributeError or returns default If specified. 

globalsO 

Returns a dictionary containing the current glohal variahies. 

hasattr(o£)/ect, name) 

Returns true if object has an attrihute called name. 


Returns the hash value of the ohject (if it has one). 

help([ofc 7 ect]) 

Invokes the huilt-in help system. No argument -> interactive help; if object is a string 
(name of a module, function, class, method, keyword, or documentation toplc), a help 
page is printed on the console; otherwise a help page on object Is qenerated. 

hex(x) 

Converts a numher xto a hexadecimal string. 

id (otyecf) 

Returns a unique Integer identifier for object. Since 2.5 always returns non-negative 
numhers. 

input([prompt]) 

Prints prompt if given. Reads input and evaluates it. Uses line editing / history if 
module readiine availahie. 
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int(x[, base]) 

Converts a number or a string to a plain integer. Optional base parameter specifies 
base from which to convert string values. 

\ntern{aString) 

Enters aString in the table of interned strings and returns the string. Since 2.3, interned 
strings are no longer 'immortal' (never garbage collected), see [detaiis] 

isinstancetoti/, 

dasslnfo) 

Returns true if obj is an instance of class dasslnfo or an object of type dasslnfo 
(dasslnfo may also be a tuple of classes or types). If issubciass (a,b) then 

isinstance(x,A) => isinstance(x,B) 


Returns true if dassl is derived from dass2 (or if classi is dass2). 

\tev{obj[,senti neiY) 

Returns an iterator on obj. If sentinei is absent, obj must be a collection implementing 

either_ iter _o or_ getitem _(). It senti ne! is given, obj will be called with no 

arg; if the value returned is equal to sentinei, stopiteration will be raised, otherwlse 
the value will be returned. See Iterators. 

\&n{obj) 

Returns the length (the number of items) of an object (sequence, dictionary, or 

Instance of class implementino len j. 

\\st{[seq]) 

Creates an empty list or a list wIth same elements as seq. seq may be a sequence, a 
Container that supports Iteration, or an Iterator object. If seq is aiready a list, returns a 

copy of it. 

localsO 

Returns a dictionary containing current local variables. 

long(x[, base]) 

Converts a number or a string to a long integer. Optional base parameter specifies the 
base from which to convert string values. 

map{function, 
sequence[, sequence, 

...]) 

Returns a list of the results of applying function to each Item from sequence(s). If more 
than one sequence is given, the function is called with an argument list consistlng of 
the corresponding Item of each sequence, substituting None for missing values when 
not all sequences have the same length. If function is None, returns a list of the items 
of the sequence (or a list of tuples if more than one sequence). => You might also 
consider using list comprehensions instead of map(). 

max(/fera£)/e[, 
key=func]) 
max(vJ, v2, ...[, 
key=func]) 

With a singie argument iterable, returns the largest item of a non-empty iterable (such 
as a string, tuple or list). With more than one argument, returns the largest of the 
arguments. The optional key arg is a function that takes a singie argument and is called 
for every value In the list. 

m\n{iterable[, 
key=func]) 
min(W, v2, ...[, 
/ce/=func]) 

With a singie argument iterable, returns the smallest item of a non-empty iterable 
(such as a string, tuple or list). With more than one argument, returns the smallest of 
the arguments. The optional key arg Is a function that takes a singie argument and Is 
called for every value in the list. 

next{iterator[, 

default]) 

Returns the next item from iterator. If iterator exhausted, returns default if specified, or 
raises stopiteration otherwise. 

objecto 

Returns a new featureless object. object is the base class for all new style classes, Its 
methods are common to all Instances of new style classes. 

oct(x) 

Converts a number to an octal string. 

open(ft7ename [, 
mode='r', [bufsize]]) 

Returns a new file object. See also alias file(). Use codecs.openO Instead to open an 
encoded file and provide transparent encoding / decoding. 

• filename is the file name to be opened 

• mode Indicates how the file Is to be opened: 

o 'r' for reading 

o 'w' for writing (truncating an existlng file) 
o 'a' opens It for appending 

o '-I-' (appended to any of the previous modes) open the file for updatlng 
(note that 'wH-'truncates the file) 

o 'b' (appended to any of the previous modes) open the file in binary mode 
o 'U' (or 'rU') open the file for reading In Universa! Newline mode: all 
varlants of EOL (CR, LF, CRH-LF) will be translated to a singie LF ('\n'). 

• bufsize is 0 for unbuffered, 1 for line buffered, negative or omitted for system 
default, >1 for a buffer of (about) the qlven size. 

ord(c) 

Returns integer ASCII value of c (a string of len 1). Works with Unicode char. 

pow(x, y[, z]) 

Returns x to power y [modulo zj. See also ** operator. 

property([/get[, fset[, 
fdel[, doc]]]]) 

Returns a property attribute for new-styie classes (classes deriving from object). fget, 
fset, and fdei are functions to get the property value, set the property value, and delete 
the property, respectively. Typical use: 

class C (object) : 

def _init_(self) : self._x = None 

def getx(self) : return self._x 

def setx(self, value): self._x = value 

def delx(self) : dei self._x 

X = property(getx, setx, delx, "I'm the 'x' property.") 
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print(*args[, sep=' '][, When_ future_.print_function is active, the print statement is replaced by this 

er)d='\n'][, function [PEP3105]. Each item in args is printed to file with sep as the delimiter, and 

/7/e=sys.stdout]) finally followed by end. 

Each of these statements: 

print 'foo', 42 

print 'foo', 42, 

print >> sys.stderr 'warning' 

can now be written in this functional form: 

print('foo', 42) 

print('foo', 42, end='') 

print('warning', file=SYS.stderr) 


range([start,] end [, 
step]) 

Returns list of ints from >= start and < end. 

With 1 arg, list from 0..arp-l 

With 2 args, list from start..end-1 

With 3 args, list from start up to end by step 

raw_input([prompt]) 

Prints prompt if given, then reads string from std input (no trailing \n). See also Input 
(). 

reduce(f, list [, init]) 

Applles the binary function f to the items of iist so as to reduce the list to a singie 
value. If init is given, it is "prepended" to list. 

reload(modu/e) 

Re-parses and re-initializes an aiready imported module. UsefuI in interactive mode, if 
you want to reload a module after fixing It. If module was syntactically correct but had 
an error In Initialization, must import It one more time before calling reload(). 

repr(obyect) 

Returns a string containing a printable and if possible evaluable representation of an 
object. < = > 'object' (using backquotes). Class redefinable (_ repr _). See also str() 

round(x, n=0) 

Returns the floatinq point value x rounded to n dlqlts after the decimal point. 

set([/terab/e]) 

Returns a set object whose elements are taken from iterable, or empty by default. See 
also Sets. 


This Is the counterpart of getattr().setattr(o, 'foobar', 3) < = > o.foobar = 3. Creates 
attribute if it doesn't existi 

slice([start,] stop[, 
step]) 

Returns a slice object representlng a range, with R/0 attributes: start, stop, step. 

sorted(/terab/e[, cmp[, 
key[, reverse]]]) 

Returns a new sorted list from the items in iterable. This contrasts with list.sort () 
that sorts lists in place and doesn't apply to immutable sequences like strings or 
tuples. See sequences.sort method. 

staticmethod 

(function) 

Returns a static method for function. A static method does not receive an implicit first 
argument. To declare a static method, use this idiom: 


class C: 

def f(argl, arg2, ...): ... 

f = staticmethod (f) 


Then call it on the class c. f () or on an Instance c () . f (). The instance is ignored 
except for its class. 

Since 2.4 you can alternatively use the decorator notation: 
class C: 

@staticmethod 

def f(argl, arg2, ...); ... 

str(object) 

Returns a string containing a nicely printable representation of an object. Class 
overridable ( str ). See also repr(). 

sum{iterable[, 

start=0]) 

Returns the sum of a sequence of numbers (not strings), plus the value of parameter. 
Returns start when the sequence is empty. 

super( type[, object- 
or-type]) 

Returns the superclass of type. If the second argument is omitted the super object 
returned is unbound. If the second argument is an object, isinstance (obj, type) 
must be true. If the second argument is a type, issubciass (type2, type) must be 
true. Typical use: 

class C(B) : 

def meth(self, arg): 

super(C, self ) .meth(arg) 

tuple([sep]) 

Creates an empty tuple or a tuple with same elements as seq. seq may be a sequence, 
a Container that supports iteration, or an iterator object. If seq is aiready a tuple, 
returns itself (not a copy). 

type(ob7) 

Returns a tvoe obiect fsee module tvoes] reoresentlno the tvoe of obi. Examole: imoort 
types If type(x) == types.StrIngType: print Tt is a string'. NB: it is better to use 
instead: if isinstance(x, types.StringType)... 
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unichrf code) 

Returns a Unicode string 1 char iong with given code. 

unicode(str/ng[, 
encoding [, error] ] ]) 

Creates a Unicode string from a 8-bit string, using the given encoding name and error 

treatment ('striet', 'ignore',or 'repiace'}. For objects which provide a_ Unicode _ o 

method, it wiii caii this method without arguments to create a Unicode string. 

vars([ohyect]) 

Without arguments, returns a dictionary corresponding to the current iocai symboi 
tabie. With a moduie, ciass or ciass instance object as argument, returns a dictionary 
corresponding to the objecfs symboi tabie. Usefui with the "%" string formatting 
operator. 


Like range(), but doesn't actuaiiy store entire iist aii at once. Good to use in "for" ioops 
when there is a biq ranqe and littie memory. 

zip(segi[, seg2,...]) 

[No, thafs not a compression tooi! For that, see moduie zipfiie] Returns a iist of tupies 
where each tupie contains the nth eiement of each of the argument sequences. Since 

2.4 returns an empty Iist if caiied with no arguments (was raising TypeError before). 


Built-In Exception classes 

BaseException 

Mother of all exceptions (was Exception before 2.5). New-style class. exception .args is a tuple of the arguments 
passed to the constructor.Since 2.6 the exception .message attribute is deprecated. 

Keyboardinterrupt & systemExit were moved out of Exception because they don't reaiiy represent errors, so now a 
try: . . .except Exception: wiii oniy catch errorS, whiie a try: . . .except BaseException: (or Simpiy 
try:. .except:) wiii stiii catch everything. 

• GeneratorExit 

Raised by the ciose () method of generators to terminate the iteration. Before 2.6 was derived from 

Exception. 

• Keyboardinterrupt 

On user entry of the interrupt key (often ' CTRL-C). Before 2.5 was derived from Exception. 

• SystemExit 

On sys.exit (). Before 2.5 was derived from Exception. 

• Exception 

Base of aii errors. Before 2.5 was the base of aii exceptions. 

o G e n er ato r Ex i t 

Moved under BaseException. 

O StandardError 

Base ciass for aii buiit-in exceptions; derived from Exception root ciass. 

■ ArithmeticError 

Base ciass for arithmetic errors. 

■ FloatingPointError 

When a fioating point operation faiis. 

■ OverflowError 

On excessiveiy iarge arithmetic operation. 

■ ZeroDivisionError 

On division or moduio operation with 0 as 2nd argument. 

■ AssertionError 

When an assert statement faiis. 

■ AttributeError 

On attribute reference or assignment faiiure 

■ EnvironmentError [new in 1.5.2] 

On error outside Python; error arg. tupie is (errno, errMsg...) 

■ lOError [changed in 1.5.2] 

I/O-reiated operation faiiure. 

■ OSError [new in 1.5.2] 

Used by the os moduie's os.error exception. 

■ WindowsError 

When a Windows-specific error occurs or when the error number does not correspond 
to an errno vaiue. 

■ EOFError 

Immediate end-of-fiie hit by input() or raw_input() 

■ ImportError 

On faiiure of import to find moduie or name. 

■ K e y b oa r di n t err u p t 
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Moved under BaseException. 

■ LookupError 

base class for IndexError, KeyError 

■ IndexError 

On out-of-range sequence subscript 

■ KeyError 

On reference to a non-existent mapping (dict) key 

■ MemoryError 

On recoverable memory exhaustion 

■ NameError 

On failure to find a local or global (unqualified) name. 

■ UnboundLocalError 

On reference to an unassigned local varlable. 

■ ReferenceError 

On attempt to access to a garbage-collected object via a weak reference proxy. 

■ RuntimeError 

Obsolete catch-all; define a suitable error instead. 

■ NotImplementedError [new in 1.5.2] 

On method not implemented. 

■ SyntaxError 

On parser encountering a syntax error 

■ IndentationError 

On parser encountering an indentation syntax error 

■ TabError 

On improper mixture of spaces and tabs 

■ System Error 

On non-fatal interpreter error - bug - report it ! 

■ TypeError 

On passing inappropriate type to built-in operator or function. 

■ ValueError 

On argument error not covered by TypeError or more precise. 

■ UnicodeError 

On Unicode-related encoding or decoding error. 

■ UnicodeDecodeError 

On Unicode decoding error. 

■ UnicodeEncodeError 

On Unicode encoding error. 

■ UnicodeTranslateError 

On Unicode translation error. 

o Stopiteration 

Raised by an iterator's next () method to signal that there are no further values. 

o Sys te mEx it 

Moved under BaseException. 

O Warning 

Base class for warnings (see module warning) 

■ DeprecationWarning 

Warning about deprecated code. 

■ FutureWarning 

Warning about a construet that will change semantically in the future. 

■ ImportWarning 

Warning about probable mistake in module import (e.g. missing_ init _ .py). 

■ OverflowWarning 

Warning about numeric overflow. Won't exist in Python 2.5. 

■ PendingDeprecationWarning 

Warning about future deprecated code. 

■ RuntimeWarning 

Warning about dubious runtime behavior. 

■ SyntaxWarning 

Warning about dubious syntax. 

■ UnicodeWarning 

When attempting to compare a Unicode string and an 8-bit string that can't be converted to 
Unicode using default ASCII encoding (raised a UnicodeDecodeError before 2.5). 

■ UserWarning 

Warning generated by user code. 
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Standard methods & operators redefinition in 
classes 

Standard methods & operators map to speciai methods '_ method _' and thus can be redefined (mostly in user- 

defined classes), e.g.: 

class C: 

def _ init _(self, v): self.value = v 

def _ add _(self, r): return self.value + r 

a ^ C(3) # sort of like calling C._init_(a, 3) 

a + 4 # is equivalent to a._add_(4) 


Speciai methods for any class 

Method 

Description 

_ new _ (c/s[, ...]) 

Instance creation (on construction). If_new_returns an instance of cis 

then_init_is caiied with the rest of the arguments (...), otherwise 

init is not invoked. More detaiis here. 

init (self, arqs) 

Instance initiaiization (on construction) 

dei (self) 

Caiied on obiect demise (refcount becomes 0) 

repr (self) 

repr () and ' ...' conversions 

str (self) 

str() and print statement 

_ sizeof _ (self) 

Returns amount of memory used by object, in bytes (caiied by 

sys . getsizeof () ). 

format (self, format spec) 

formato and str.formato conversions 

_ cmp _ (self,other) 

Compares self to other and returns <0, 0, or >0. Impiements >, <, = = 
etc... 

_ index _ (self) 

[PEP357] Aiiows using any object as integer indice (e.g. for siicing). Must 
return a sinqie integer or iong integer vaiue. 

_ It _ (self, other) 

Caiied for self < other comparisons. Can return anything, or can raise an 
exception. 

_ le _ (self, other) 

Caiied for self <= ofher comparisons. Can return anything, or can raise an 
exception. 

_ gt _ (self, other) 

Caiied for self > other comparisons. Can return anything, or can raise an 
exception. 

_ ge _ (self, other) 

Caiied for self >= ofher comparisons. Can return anything, or can raise an 
exception. 

_ eq _ (self, other) 

Caiied for self == ofher comparisons. Can return anything, or can raise an 
exception. 

_ ne _ (self, other) 

Caiied for self != other (and self <> other) comparisons. Can return 
anything, or can raise an exception. 

_ hash _ (self) 

Compute a 32 bit hash code; hasho and dictionary ops. Since 2.5 can 
aiso return a Iong integer, in which case the hash of that vaiue wiii be 

taken.Since 2.6 can set_ hash _ = None to void ciass inherited 

hashability. 

_ nonzero _ (self) 

Returns 0 or 1 for truth vaiue testing. when this method is not defined, 

_ len _ 0 is caiied if defined; otherwise aii ciass instances are considered 

"true". 

_ getattr _ (self,name) 

Caiied when attribute iookup doesn't find name. See aiso 
getattribute 

_getattribute _( self, name) 

Same as_getattr_but always caiied whenever the attribute name is 

accessed. 

_dir _( self) 

Returns the iist of names of vaiid attributes for the object. Caiied by buiitin 

fct dir (), but ignored uniess_ getattr _or_ getattribute _ iS 

defined. 

_ setattr _ (self, name, value) 

Caiied when setting an attribute (inside, don't use "self.name = vaiue", 
use instead "self. dict fname] = vaiue") 

delattr (self, name) 

Caiied to deiete attribute <name>. 

_ call _ (self, *args, **kwargs) 

Caiied when an instance is caiied as function: obj (argi, arg2, .. .) is a 
shorthand for obj . call(argl, arg2, ...). 
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Operators 

See list in the operator module. Operator function names are provided with 2 variants, with or without leading & 
trailing '_' (e.g._ add _or add). 


Numeric operatioris speciai methods 

Operator 

Speciai method 

self + other 

add (self, other) 

self - other 

sub (self, other) 

self * other 

mul (self, other) 

self / other 

div (self, other) or truediv (self,other) If future.division is active. 

self II other 

floordiv (self, other) 

self % other 

mod (self, other) 

d\\fmod{self,other) 

divmod (self, other) 

self * * other 

pow (self, other) 

self & other 

and (self, other) 

self ^ other 

xor (self, other) 

self 1 other 

or (self, other) 

self << other 

Ishift (self, other) 

self >> other 

rshift (self, other) 

bool(se/n 

nonzero (self) (used in boolean testing) 

-self 

neq (self) 

+self 

pos (self) 

abs(self) 

abs (self) 

i^self 

invert (self) (bitwise) 

self += other 

iadd (self, other) 

self-= other 

isub (self, other) 

self * = other 

imul (self, other) 

self /= other 

idiv (self, other) or itruediv (self,other) if future.division is in effect. 

self // = other 

iftoordiv (self, other) 

self°/o= other 

i mod (self, other) 

self * * = other 

i DOW (self, other) 

self &= other 

iand (self, other) 

self other 

i xor (self, other) 

self 1 = other 

ior (self, other) 

self <<= other 

iishift (self, other) 

self>>= other 

irshift (self, other) 


Conversions 

built-in function 

Speciai method 

int(se/f) 

int (self) 

long(se/0 

lonq (self) 

float(se/f) 

float (self) 

complex(se/f) 

complex (self) 

oct(self) 

oct (self) 

h ex (se/0 

hex (self) 

coercefse/f, other) 

coerce (self, other) 


Right-hand-side equivalents for all binary operators exist (_radd_,_rsub_,_rmul_,_rdiv_, ...). 

They are called when class instance is on r-h-s of operator: 

• a + 3 calls_ add_(a, 3) 

• 3 + a calls_ radd_(a, 3) 


Speciai operations for containers 

Operation 

Speciai method 

Notes 

AII sequences and maps : 

len(se/0 

len (self) 

length of obiect, >= 0. Length 0 == false 

seiflk] 

_getitem_ (self, k) 

Get element at indice /key k (indice starts at 0). Or, if k 
is a slice obiect, return a slice. 


_missing (self, key) 

Hook called when key Is not found In the dictionary. 
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returns the default value. 

se//Tkl = value 

setitem (self, k, value) 

Set element at indice/key/slice k. 

dei seiflk] 

delitem (self, k) 

Delete element at indice/key/slice k. 

elt in self 
elt not in self 

_contains_ (self, elt) 

not contains (self, elt) 

More efficient than std iteration thru sequence. 

iter(self) 

_iter_ (self) 

Returns an iterator on elements (keys for mappings 
< = > se/f.iterkeysO). See iterators. 

Sequences, general methods, plus: 

self[i:j] 

_getsiice_ (self, 1, j) 

Deprecated since 2.0, replaced by_getitem_with a 

slice obiect as parameter. 

se//T^i:j] = seq 

_setsiice_ (self, 1, j,seq) 

Deprecated since 2.0, replaced by_setitem_with a 

slice obiect as parameter. 

dei se//i;i:j] 

_deislice_ (self, l,j) 

Same as self[i:j] = [] - Deprecated since 2.0, replaced 
by delitem with a slice object as parameter. 

self * n 

mul (self, n) 

( reoeat in the officiai doc but doesn't work!) 

self + other 

add (self, other) 

( concat in the officiai doc but doesn't work!) 

Mappings, general methods, plus: 

hash(se/0 

hash (self) 

hashed yalue of obiect se/fis used for dictionary keys 


SpeciaI informative state attributes for some 
types: 

Tip: use module inspect to inspect live objects. 


Lists & Dictionaries 

Attribute 

Meaning 

■ ■ ■ 

r 1 ■ 1 i-N / 1 /'II !■! ■ ■ . . . . • 1 1 

H1B1110 O 



Modules 

Attribute 

Meaning 

doc 

(strinq/None, R/0): doc string (< = > dict f' doc '1) 

name 

(strinq, R/0): module name (also in dict f' name 'D 

_package_ 

(string/None, R/W): If defined, package name used for relative imports (also in_dict_ 

r oackaoe 'D. rPEP3661. 

dict 

(dict, R/0): module's name space 

_file_ 

(string/undefined, R/0): pathname of .pyc, .pyo or .pyd (undef for modules statically linked to 
the interpreter). Before 2.3 use sys.argv[0] instead to find the current script filename. 

path 

(list/undefined, R/W): List of directory paths where to find the package (for packages oniy). 


Classes 

Attribute 

Meaning 

doc 

(string/None, R/W): doc string (< = > dict (' doc 'D 

name 

(string, R/W): class name (also in dict (' name 'D 

module 

(string, R/W): module name in which the class was defined 

bases 

(tuple, R/W): parent classes 

dict 

(dict, R/W): attributes (class name space) 


Instances 

Attribute 

Meaning 

class 

(class, R/W): instance's class 

dict 

(dict, R/W): attributes 


User defined functions 

Attribute 

Meaning 

doc 

(strinq/None, R/W): doc strinq 

name 

(strinq, R/0): function name 

func doc 

(R/W): same as doc 

func name 

(R/0, R/W from 2.4): same as name 

func defaults 

(tuple/None, R/W): default arqs yalues if any 
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func code 

(code, R/W): code obiect representing the compiled function body 

func globals 

(dict, R/0): ref to dictionary of fune qlobal variables 


User-defined Methods 


Attribute 

Meaning 

doc 

(strinq/None, R/0): Doc strinq 

name 

(strinq, R/0): Method name (same as im fune, name ) 

im class 

(class, R/0): Class defininq the method (may be a base class) 

im_self 

(instance/None, R/0): Target instance object (None if unbound). Since 2.6 use_ seif _instead, 

will be deprecated in 3.0. 

self 

(instance/None, R/0): Target instance object (None if unbound). 

im func 

(function, R/0): Function object. Since 2.6 use fune instead, wiii be deprecated in 3.0. 

fune 

(function, R/0): Function object. 


Built-in Functions & methods 


Attribute 

Meaning 

doc 

(strinq/None, R/0): doc strinq 

name 

(strinq, R/0): function name 

self 

[methods oniyj tarqet object 

members 

iist of ottr nomes; f' doc nome seif 'D' Deprecated. use dirO instead. 


Codes 


Attribute 

Meaning 

co name 

(strinq, R/0): function name 

co argcount 

(int, R/0): number of positionai arqs 

co nlocals 

(int, R/0): number of iocai vars (inciudinq arqs) 

co varnames 

(tupie, R/0): names of iocai vars (startinq with arqs) 

co code 

(strinq, R/0): sequence of bytecode instructions 

co consts 

(tupie, R/0): iiterais used by the bytecode, Ist one is function doc (or None) 

co names 

(tupie, R/0): names used by the bytecode 

co filename 

(strinq, R/0): fiiename from which the code was compiied 

co firstlineno 

(int, R/0): first iine number of the function 

co lnotab 

(strinq, R/0): strinq encodinq bytecode offsets to iine numbers. 

co stacksize 

(int, R/0): required stack size (inciudinq iocai vars) 

co_flags 

(int, R/0): fiags for the interpreter bit 2 set if fet uses "*arg" syntax, bit 3 set if fet uses 
'**keywords' syntax 


Frames 

Attribute 

Meaning 

f back 

(frame/None, R/0): previous stack frame (toward the caiier) 

f code 

(code, R/0): code object being exeeuted in this frame 

f locals 

(dict, R/0): iocai vars 

f globals 

(dict, R/0): qiobai vars 

f builtins 

(dict, R/0): buiit-in (intrinsic) names 

f restricted 

(int, R/0): fiaq indicatinq whether fet is exeeuted in restricted mode 

f lineno 

(int, R/0): current iine number 

f lasti 

(int, R/0): precise instruction (index into bytecode) 

f trace 

(function/None, R/W): debuq hook caiied at start of each source iine 

f exc type 

(Type/None, R/W): Most recent exception type 

f exc value 

(any, R/W): Most recent exception vaiue 

f exc traceback 

(traceback/None, R/W): Most recent exception traceback 


Tracebacks 

Attribute 

Meaning 

tb next 

(frame/None, R/0): next ievei in stack trace (toward the frame where the exception occurred) 

tb frame 

(frame, R/0): exeeution frame of the current ievei 

tb lineno 

(int, R/0): iine number where the exception occured 

tb lasti 

(int, R/0): precise instruction (index into bytecode) 


Slices 

Attribute 

Meaning 

start 

(any/None, R/0): iowerbound, inciuded 

stop 

(any/None, R/0): upperbound, exciuded 
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step_ I (any/None, R/Q): step value 


Complex numbers 

Attribute 

Meaning 

real 

(float, R/0): real part 

_ 

(float, R/0): imaqinary part 


xranges 


Attribute 

Meaning 

tolist 

(Built-in method, R/0): ? 


Important Modules 

sys 

System-specific parameters and functions. 


Some sys variables 


Variable 

Content 

argv 

The list of command line arguments passed to a Python script. sys. argv [ o ] is the 
script name. 

builtin_module_names 

A list of strings giving the names of ali modules written in C that are linked into this 
interpreter. 

byteorder 

Native byte order, either 'biq'(-endian) or 'little'(-endian). 

eheek_mterval 

How often to check for thread switches or signais (measured in number of Virtual 
machine instructions). Deprecated (since ??), use method getcheckintervai () 
instead. 

Copyright 

A strinq containinq the Copyright pertaininq to the Python interpreter. 

dont_write_bytecode 

If True, prevents Python from from writing .pyc or .pyo files (same as invocation 
option -B). 

exec_prefix 

Root directory where platform-dependent Python files are installed, e.g. 

prefix 

'C:\\Python2'/usr'. 

executable 

Name of executable binary of the Python interpreter (e.g. 'C:\\Python23 
\\python.exe', '/usr/bin/python') 

exitfunc 

User can set to a parameterless function. It will get called before interpreter exits. 
Deprecated since 2.4. Code shouid be using the existing atexit module 

flaqs 

Status of command line flaqs, as a R/0 struet, fdetailsl 

float_info 

A struetseq holding Information about the float type (precision, internal 
representation, etc...). fdetailsl 

last_type, last_value, 

Set oniy when an exception not handied and interpreter prints an error. Used by 

last traceback 

debuqqers. 

maxint 

Maximum positive value for integers. Since 2.2 integers and long integers are 
unified, thus integers have no limit. 

maxunicode 

Largest supported code point for a Unicode character. 

modules 

Dictionary of modules that have aiready been loaded. 

path 

Search path for extern a 1 modules. Can be modified by program. sys.path[0] = = 
directory of script currently exeeuted. 

platform 

The current platform, e.g. "sunosS", "win32" 

psl, ps2 

Prompts to use in Interactive mode, normally ">>>" and "..." 

stdin, stdout, stderr 

File objects used for I/O. One can redirect by assigning a new file object to them (or 
any object: with a method write (string) for stdout/stderr, or with a method 

readline () for Stdin). _ stdin_,_stdout _and _ stderr _are the default 

values. 

subversion 

Info about Python build version in the Subversion repository: tuple (interpreter- 
name, branch-name, revision-range), e.g. ecpython’, ’tags/r25’, '51908' )■ 

version 

String containing version info about Python interpreter. 

version info 

Tuple containing Python version info - (major, minor, micro, level, seriai). 

winver 

Version number used to form registry keys on Windows platforms (e.g. '2.2'). 
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Some sys functions 


Function 

Resuit 

_current_frames() 

Returns the current stack frames for aii running threads, as a dictionary mapping 
thread identifiers to the topmost stack frame currentiy active in that thread at the 
time the function is caiied. 

dispiayhook 

The function used to dispiay the output of commands issued in interactive mode - 
defauits to the buiitin repr o . dispiayhook is the originai vaiue. 

excepthook 

Can be set to a user defined function, to which any uncaught exceptions are passed. 
excepthook is the originai vaiue. 

exit(n) 

Exits with status n (usuaiiy 0 means OK). Raises systemExit exception (hence can 
be caught and iqnored by proqram) 

getcheckintervaiO / 
setcheckintervai(/nterva/) 

Gets / Sets the interpreter's thread switching intervai (in number of bytecode 
instructions, defauit: 10 untii 2.2, 100 from 2.3). 

g etrefco u n t( object) 

Returns the reference count of the object. Generaiiy 1 higherthan you might 
expect, because of object arq temp reference. 

getsizeof(ob/ect[, default]) 

Returns the amount of memory used by object, in bytes. Caiis o._sizeof _{) if 

avaiiabie. default returned if size can't be determined. fdetaiisj 

settra ce (fune) 

Sets a trace function: caiied before each iine of code is exited. 

setprofiie(/unc) 

Sets a profiie function for performance profiiinq. 

exc_info() 

Info on exception currentiy being handied; this is a tupie (exc_type, exc_vaiue, 
exc_traceback). Warning: assigning the traceback return vaiue to a iocai variabie 
in a function handiinq an exception wiii cause a circuiar reference. 

setdefauitencoding 

(encodinq) 

Change defauit Unicode encoding - defauits to 7-bit ASCII. 

getrecursioniimitO 

Retrieve maximum recursion depth. 

setrecursioniimitO 

Set maximum recursion depth (defauit 1000). 


OS 

Miscellaneous operating system interfaces. Many functions, see the for a comprehensive iist! 

"synonym" for whatever OS-specific moduie (nt, mac, posix...) is proper for current environment. This moduie uses 
posix whenever possibie. 

See aiso M.A. Lemburg's utility piatform.py (now inciuded in 2.3+). 


Some os variables 

Variabie 

Meaning 

name 

name of 0/S-specific module (e.g. "posix", "mac", "nt") 

path 

0/S-specific module for path manipulations. 

On Unix, os . path. split () < = > posixpath. split () 

curdir 

string used to represent current directory (eg '.') 

pardir 

strinq used to represent parent directory (eq '..') 

sep 

string used to separate directories ('/' or '\'). Tip: Use os .path. join () to build portable paths. 

aitsep 

Alternate separator if applicable (None otherwise) 

pathsep 

character used to separate search path components (as in $PATH), eg. for Windows. 

iinesep 

line separator as used in text files, ie '\n' on Unix, '\r\n' on Dos/Win, '\r' on Mac. 


Some os functions 

Function 

Resuit 

makedirs(path[, mode=0777]) 

Recursive directory creation (create required intermediary dirs); os.error if 
faiis. 

removedirs(path) 

Recursive directory delete (delete intermediary empty dirs); faiis (os.error) if 
the directories are not empty. 

renames(o/cf, new) 

Recursive directory or file renaming; os.error if faiis. 

urandom(n) 

Returns a strinq containinq n bytes of random data. 


posix 

Posix OS interfaces. 

Do not import this moduie directiy, import os instead ! (see aiso moduie: shutii for fiie copy & remove functions) 
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posix Variables 


Variable 

Meaning 

environ 

dictionary of environment variables, e.g. posix.environ[ 'home' ]. 

error 

exception raised on POSIX-related error. 

Correspondinq value is tuple of errno code and perrorO strinq. 


Some posix functions 

Function 

Resuit 

access{path, mode) 

Returns True if the requested access to path is qranted. Use mode=F_OK to 
check for existence, or an OR-ed combination of r_ok, w_ok, and x_ok to check 
for r, w, X permissions. 

cM\r(path) 

Chanqes current directory to path. 

chmodipath, mode) 

Chanqes the mode of path to the numeric mode 

c\ose(fd) 

Closes file descriptor fd opened with posix.open. 

_exit(n) 

Immediate exit, with no cleanups, no SystemExit, etc... Shouid use this to exit a 
child process. 

execvfp, args) 

"Become" executable p with args args 

qetcwdO 

Returns a strinq representinq the current workinq directory. 

qetcwduO 

Returns a Unicode strinq representinq the current workinq directory. 

qetpidO 

Returns the current process id. 

qetsidO 

Calis the System call qetsidf) [Unix]. 

forkO 

Like C's fork(). Returns 0 to child, child pid to parent [Not on Windows]. 

kill(p/d, signa!) 

Like C's kill [Not on Windows]. 

Iistdir(paff7) 

Lists (base)names of entries in directory path, excludinq and If path is a 

Unicode strinq, so will be the returned strinqs. 

\seek(fd, pos, how) 

Sets current position in file fd to position pos, expressed as an offset relative to 
beqinninq of file {how=Q), to current position {how=l), orto end of file 
(how=2). 

mkdir(paf/?[, mode]) 

Creates a directory named path with numeric mode (default 0777). Actual 
permissions = {mode & ~umask & 0777). To set directiy the permissions, use 
chmodo after dir creation. 

open(/y/e, flags, mode) 

Like C's open(). Returns file descriptor. Use file object functions rather than this 
low level ones. 

pipeO 

Creates a pipe. Returns pair of file descriptors (r, w) [Not on Windows]. 

popen{command, mode='r', 
bufSize=0) 

Opens a pipe to or from command. Resuit is a file object to read to or write 
from, as indicated by mode beinq 'r' or 'w'. Use it to catch a command output ('r' 
mode), or to feed it ('w' mode). 

remove{path) 

S66 unlink. 

rename(oW, new) 

Renames/moves the file or directory old to new. [error if tarqet name aiready 
exists] 

renames(o/cf, new) 

Recursive directory or file renaminq function. Works like rename(), except 
creation of any intermediate directories needed to make the new pathname 
good is attempted first. After the rename, directories correspondinq to riqhtmost 
path segments of the old name will be pruned away usinq removedirs(). 

rmdkipath) 

Removes the empty directory path 

readifd, n) 

Reads n bytes from file descriptor fd and return as strinq. 

stat{path) 

Returns st_mode, st_ino, st_dev, st_nlink, st_uid,st_qid, st_size, st_atime, 
st mtime, st ctime. [st ino, st uid, st qid are dummy on Windows] 

SYStem(command) 

Executes strinq command in a subshell. Returns exit status of subshell (usually 0 
means OK). Since 2.4 use subprocess.callO instead. 

times() 

Returns accumulated CPU times in sec (user, system, children's user, children's 
sys, elapsed real time) [3 last not on Windows]. 

unlink(paf/7) 

Uniinks ("deletes") the file (not dir!) path. Same as: remove. 

utimefpafb, (aTime, mTime)) 

Sets the access & modified time of the file to the given tuple of values. 

wait() 

Waits for child process completion. Returns tuple of pid, exit_status [Not on 
Windows]. 

waitpid(p/d, options) 

Waits for process pid to complete. Returns tuple of pid, exit_status [Not on 
Windows]. 

walk(top[, topdown=lv\ie [, 
onerror=None[, 
followlinks= False] ]]) 

Generates a list of file names in a directory tree, by waikinq the tree either top 
down or bottom up. For each directory in the tree rooted at directory top 
(includinq top itself), it yields a 3-tuple (dirpath, dirnames, filenames) - more 
info here. See also os .path.waik o . 

2.6: New foiiowiinks parameter. If True, visit directories pointed to by links 
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(beware of infinite recursioni). 

write(/y, str) 

Writes str to file fd. Returns nb of bytes written. 


posixpath 

Posix pathname operations. 

Do not import this module directly, import os instead and refer to this module as os.path. (e.g. os .path.exists (p) )l 


posixpath functions 

Function 

Resuit 

abspathfpafb) 

Returns absolute path for path, takinq current workinq dir in account. 

commonprefix(//sf) 

Returns the longuest path prefix (taken character-by-character) that is a prefix of ali paths 
in list (or " if iist empty). 

dirname/basename 

(path) 

directory and name parts of path. See also split. 

ex\sts{path) 

True if path is the path of an existing file or directory. See also lexists. 

expanduserfpafb) 

Returns a copy of path with expansion done. 

expandvars(paf/7) 

Returns string that is (a copy of) path with environment vars $name or ${name} expanded. 
[Windows: case significant; must use Unix: $var nototion, not %var%; 2.6: Notation % 
namei also supported.] 

getatimefpaf/?) 

Returns last access time of path (integer nb of seconds since epoch). 

qetctimefpaf/?) 

Returns the metadata chanqe time of path (integer nb of seconds since epoch). 

qetmtimefpafb) 

Returns last modification time of path (integer nb of seconds since epoch). 

getsize(paf/7) 

Returns the size in bytes of path. os. error if file inexistent or inaccessible. 

\sabs{path) 

True if path is absolute. 

isdirfpafb) 

True if path is a directory. 

isfilefpafb) 

True if path is a reguiar file. 

islinkfpafb) 

True if path is a symbolic link. 

ismountfpaf/?) 

True if path is a mount point [true for ali dirs on Windows). 

join(p[,c?[,...]]) 

Joins one or more path components in a way suitable for the current OS. 

lexists(paf/7) 

True if the file specified by path exists, whether or not it's a symbolic link (uniike exists). 

normcasefpafb) 

Normalizes case of path. Has no effect under Posix. 

normpath(paf/7) 

Normalizes path, eliminating double siashes, etc... 

realpath(paf/7) 

Returns the canonical path for path, eliminating any symbolic links encountered in the 
path. 

relpath(paf/7[, 

Returns a relative filepath to path, from the current directory by default, or from start if 

sfarf]) 

specified. 

samefileffJ, /2) 

True if the 2 paths fl and /2 reference the same file. 

sameopenfileffJ, /2) 

True if the 2 open file obiects fl and f2 reference the same file. 

samestatfst, s2) 

True if the 2 stat buffers sl and s2 reference the same file. 

split(p) 

Splits p into (head, taii) where taii is last pathname component and head is everything 
leading Up to that. < = > (dimame (p) , basename (p) ) 

splitdrive(p) 

Splits path p in a pair ('drive:', taii) [Windows] 

splitext(p) 

Splits into (root, ext) where last comp of root contains no periods and ext is empty or 
starts with a period. 2.6: Do not split on leading period. 

walk(p, visit, arg) 

Calis the function visit with arguments (arg, dirname, names) for each directory recursively 
in the directory tree rooted at p (including p itself if it's a dir). The argument dirname 
specifies the visited directory, the argument names lists the files in the directory. The visit 
function may modify names to influence the set of directories visited below dirname, e.g. 
to avoid visiting certain parts of the tree. See also os.waiko for an alternative. 


shutii 

Hlgh-level file operations (copying, deleting). 


Main shutii functions 

Function 

Resuit 

copyfsrc, dest) 

Copies the contents of file src to file dest, retaininq file permissions. 

copytree(src, dest[. 

Recursively copies an entire directory tree rooted at src into dest (which shouid not 

symiinks=Fa\se[, 

aiready exist). If symiinks is true, links in src are kept as such in dest. 

/gnore=l\lone]]) 

2.6: New ignore callable argument. Will be called with each directory path and a list 
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of the directory's contents, must return a list of names to ignore. 

shutii. ignore_patterns () can be used to exclude glob-style patterns, e.g.: 


shutii.copytree('projects/myProjUnderSvn ', ' exportDir ', ignore=shutil.ignore patterns(', 

'.svn')) 


move(src, dest) 

Recursively moves a file or directory to a new location. 

rmtree(paff?[, 
ignore_errors[, onerror]]) 

Deletes an entire directory tree, ignoring errors if ignore_errors is true, or calling 
onerror(func, path, sys.exc_info()) if supplied, with arguments fune (faulty function), 
and path (concerned file). This fet faiis when the files are Read Oniy. 


(and also: copyfUe, copymode, copystat, copy2) 

time 

Time access and conversions. 

(see also module mxDateTime if you need a more sophisticated date/time management) 


Variables 

Variable 

Meaning 

altzone 

Siqned offset of local DST timezone in sec west of the Oth meridian. 

dayiiqht 

Non zero if a DST timezone is specified. 

timezone 

The offset of the local (non-DST) timezone, in seconds west of UTC. 

tzname 

A tuple (name of local non-DST timezone, name of local DST timezone). 


Some functions 


Function 


Resuit 


clock() 


On Unix: current processor time as a floating point number expressed in 
seconds. 

On Windows: wall-clock seconds elapsed since the Ist call to this function, as 
a floating point number (precision < Ips). 


timeQ 


Returns a float representing UTC time in seconds since the epoch. 


gmtime([secs]), 

localtime([secs]) 


Returns a 9-tuple representing time. Current time is used if secs is not 
provided. 

Since 2.2, returns a struct_time object (stili accessible as a tuple) with the 


Index 

Attribute 

Values 

0 

tm year 

Year (e.g. 1993) 

1 

tm mon 

Month [1,12] 

2 

tm mday 

Day [1,311 

3 

tm hour 

Hour [0,231 

4 

tm min 

Minute [0,59] 

5 

tm_sec 

Second [0,61]; The 61 accounts for leap seconds and 
(the very rare) double leap seconds. 

6 

tm wday 

Weekday [0,6], Monday is 0 

7 

tm yday 

Julian day [ 1,366] 

8 

tm_isdst 

Dayiight flag: 0, 1 or -1; -1 passed to mktime () will 
usually work 


asctime([f/merup/e]). 


24-character string of the following form: 'Mon Apr 03 08:31:14 2006'. 
timeTuple defaults to locaitime () if omitted. 


ctime([secs]) 


equivalent to asctime (locaitime (secs) ) 


mktime(f/merup/e) 


Inverse of locaitimeQ. Returns a float representing a number of seconds. 


strftime(formaf[, timeTuple]) 


Formats a time tuple as a string, according to format (see table below). 
Current time is used if timeTuple is omitted. 


strptime(sfr;ng[, format]) 


Parses a string representing a time according to format (same format as for 
strftimeo, see below), default "%a %b %d %H:%M:%S %Y" = asctime 
format. 

Returns a time tuple/struct time. 


sleep(secs) 


Suspends execution for secs seconds. secs can be a float. 


Formatting in strftime() and strptime() 

Directi ve 

Meaning 

%a 

Locale's abbreviated weekday name. 

%A 

Locale's full weekday name. 
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%b 

Locaie's abbreviated month name. 

%B 

Locaie's fuii month name. 

%C 

Locaie's appropriate date and time representation. 

%d 

Day of the month as a decimai number [01,31]. 

%H 

Hour (24-hour ciock) as a decimai number [00,23]. 

%I 

Hour (12-hour ciock) as a decimai number [01,12]. 

% j 

Day of the year as a decimai number [001,366]. 

%m 

Month as a decimai number [01,12]. 

%M 

Minute as a decimai number [00,59]. 

%p 

Locaie's equivaient of either AM or PM. 

%S 

Second as a decimai number [00,61]. Yes, 61 ! 

%U 

Week number of the year (Sunday as the first day of the week) as a decimai number [00,53]. Aii days 
in a new year preceding the first Sunday are considered to be in week 0. 

%w 

Weekday as a decimai number [0(Sunday),6]. 

%W 

Week number of the year (Monday as the first day of the week) as a decimai number [00,53]. Aii days 
in a new year preceding the first Sunday are considered to be in week 0. 

%x 

Locaie's appropriate date representation. 

%X 

Locaie's appropriate time representation. 

%y 

Year without century as a decimai number [00,99]. 

%Y 

Year with century as a decimai number. 

%Z 

Time zone name (or by no characters if no time zone exists). 

%% 

A iiterai "%" character. 


string 

Common string operations. 

As of Python 2.0, much (though not all) of the functionality provided by the string moduie have been superseded by 
buiit-in string methods - see Operations on strings for detaiis. 


Some string variables 

Variable 

Meaning 

diqits 

The string '0123456789'. 

hexdiqits, octdiqits 

Legai hexadecimai & octai diqits. 

ietters, uppercase, iowercase, whitespace 

Strings containinq the appropriate characters. 

ascii ietters, ascii iowercase, ascii uppercase 

Same, taking the current locale in account. 

index error 

Exception raised by index o if substring not found. 


Some string functions 

Function 

Resuit 

expandtabsfs, tabSIze) 

Returns a copy of string s with tabs expanded. 

find/rfind(s, sub[, start=0[, end=0]) 

Returns the iowest/highest index in s where the substring sub is 
found such that sub is whoiiy contained in s[start-.end]. Return - 
1 if sub not found. 

ijust/rjust/center(s, wiclth[, flllChar=' ']) 

Returns a copy of string s; ieft/right justified/centered in a fieid 
of given width, padded with spaces or the given character, s is 
never truncated. 

iower/upper(s) 

Returns a string that is (a copy of) s in iowercase/uppercase. 

spiit(s[, sep=whitespace[, maxsp//t=0]]) 

Returns a iist containing the words of the string s, using the 
string sep as a separator. 

rspiit(s[, sep=whitespace[, maxspllt=0]]) 

Same as spiit above but starts spiitting from the end of string, 
e.g. ' A, B, C ' . spiit ( ’ , ' , 1) == ['A', 'B,C'] but 

’ A,B,C ' .rsplit (',’, 1) == ['A,B', 'C'] 

join(words[, sep=' ']) 

Concatenatos a iist or tupie of words with intervening 
separators; inverse of spiit. 

repiace(s, old, new[, maxspllt=0] 

Returns a copy of string s with aii occurrences of substring old 
repiaced by new. Limits to maxsplit first substitutions if 
specified. 

strip(s[, c/7ars=None]) 

Returns a string that is (a copy of) s without ieading and traiiing 
chars (defauit: whitespace), if any. Aiso: istrip, rstrip. 
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re (sre) 

Regular expressiori operatioris. 

Handies Unicode strings. Impiemented in new moduie sre, re now a mere front-end for compatibiiity. 
Patterns are specified as strings. Tip: Use raw strings (e.g. r'\w*') to literaiize backsiashes. 


Regular expression syntax 

Form 

Descriptiori 


Matches any character (inciudinq newline if DOTALL fiaq specified). 

A 

Matches start of the string (of every iine in MULTILINE mode). 

$ 

Matches end of the string (of every iine in MULTILINE mode). 

* 

0 or more of precedinq reguiar expression (as many as possibie). 

+ 

1 or more of precedinq reguiar expression (as many as possibie). 

? 

0 or 1 occurrence of precedinq reguiar expression. 

+? ?? 

Same as *, + and ? but matches as few characters as possibie. 

{m,n} 

Matches from m to n repetitions of precedinq RE. 

{m,n}? 

Idem, attemptinq to match as few repetitions as possibie. 

[] 

Defines character set: e.g. 'fa-zA-Zl' to match aii ietters (see aiso \w \S). 

] 

Defines compiemented character set: matches if char is NOT in set. 

\ 

Escapes speciai chars '*?+&$!()' and introduces speciai sequences (see beiow). Due to Python 
string ruies, write as '\\' or r'\' in the pattern string. 

W 

Matches a iitterai due to Python string ruies, write as '\\\\' in pattern string, or better using 

raw string: r'\\'. 

1 

Specifies aiternative: 'foolbar' matches 'foo' or 'bar'. 

(...) 

Matches any RE inside (), and deiimits a group. 

(?:...) 

Idem but doesn't deiimit a group (non capturing parenthesis). 

(? 

P<name>...) 

Matches any RE inside (), and deiimits a named group, (e.g. r'(?P</d>[a-zA-Z_]\w*)' defines a 
group named id). 

(?P=name) 

Matches whatever text was matched by the eariier group named name. 

(?=...) 

Matches if ... matches next, but doesn't consume any of the string e.g. 'Isaac (?=Asimov)' 
matches 'Isaac' oniy if foiiowed by 'Asimov'. 

(?!...) 

Matches if ... doesn't match next. Negative of (?=...). 

(?< = ...) 

Matches if the current position in the string is preceded by a match for ... that ends at the current 
position. This is caiied a positive iookbehind assertion. 

(?<!...) 

Matches if the current position in the string is not preceded by a match for .... This is caiied a 
negative iookbehind assertion. 

i?{group) 

A\B) 

[2.4+] group is either a numeric group ID or a group name defined with (?pgroup. . . ) eariier in 
the expression. If the specified group matched, the regular expression pattern A will be tested 
aqainst the string; if the group didn't match, the pattern B will be used instead. 

(?#...) 

A comment; ignored. 

(7letters) 

Ietters is one or more of 'i','L', 'm', 's', 'u', 'x'. Sets the corresponding flags (re.I, re.L, re.M, re.S, 
re.U, re.X) for the entire RE. See the compiie () function for equivalent flags. 


Speciai sequences 

Sequence 

Descriptiori 

\number 

Matches content of the group of the same number; qroups are numbered startinq from 1. 

\A 

Matches oniy at the start of the string. 

\b 

Empty str at beginning or end of word\ '\bis\b' matches 'is', but not 'his'. 

\B 

Empty str NOT at beginning or end of word. 

\d 

Any decimal digit (< = > [0-9]). 

\D 

Any non-decimal digit char (< = > [^0-9]). 

\s 

Any whitespace char (< = > [ \t\n\r\f\v]). 

\s 

Any non-whitespace char (< = > [^ \t\n\r\f\v]). 

\w 

Any alphaNumeric char (depends on LOCALE fiaq). 

\W 

Any non-alphaNumeric char (depends on LOCALE fiaq). 

\z 

Matches oniy at the end of the string. 


Variables 


Variabie 

Meaning 

error 

Exception when pattern string isn't a valid regexp. 
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Functions 


Function 

Resuit 

comp\\e{pattern[,flags=0]) 

Compiles a RE pattern string into a regular expression object. 

Flags (combinable by |): 

I or IGNORECASE < = > (?i) 
case insensitive matching 

L or LOCALE < = > (?L) 

make \w, \W, \b, \B dependent on the current locale 

M or MULTILINE < = > (?m ) 

matches every new line and not oniy start/end of the whole string 

S orDOTALL < = > (?s) 

matches ALL chars, including newline 

U or UNICODE < = > (?u) 

Make \w, \W, \b, and \B dependent on the Unicode character properties 
database. 

X or VERBOSE < = > (?x) 

Ignores whitespace outside character sets 

escape(strinq) 

Returns (a copy ofj string with all non-alphanumerics backslashed. 

match(pattern, string[, flags]) 

If 0 or more chars at beginning of string matches the RE pattern 
string, returns a corresponding MatchObject instance, or None if no 
match. 

search{pattern, string[, flags]) 

Scans thru string for a location matching pattern, returns a 
corresponding MatchObject instance, or None if no match. 

sp\\t(pattern, stringi, maxsplit=0]) 

Splits string by occurrences of pattern. If capturing () are used in 
pattern, then occurrences of patterns or subpatterns are also 
returned. 

f\nda\\{pattern, string) 

Returns a list of non-overlapping matches of pattern in string, either 
a list of groups or a list of tuples if the pattern has more than 1 
qroup. 

f\nd\ter{pattern, stringi, fisgs]) 

Returns an iterator over all non-overlapping matches of pattern in 
string. For each match, the iterator returns a match object. Empty 
matches are included in the resuit uniess they touch the beginning of 
another match. 

subipattern, repi, stringi, count=0]) 

Returns string obtained by replacing the (counf first) leftmost non- 
overlapping occurrences of pattern (a string or a RE object) in string 
by rep/; repi can be a string or a function called with a singie 

MatchObj arg, which must return the replacement string. 

subn(pattern, repi, stringi, count=0]) 

Same as subO, but returns a tuple (newString, 
numberOfSubsMade). 


Regular Expressiori Objects 

RE objects are returned by the compile function. 


re object attributes 

Attribute 

Descriptiori 

flags 

Flags arg used when RE obj was compiled, or 0 if none provided. 

groupindex 

Dictionary of {qroup name: qroup number> in pattern. 

pattern 

Pattern string from which RE obj was compiled. 


re object methods 

Method 

Resuit 

match(sfr/ng[, pos][, endpos]) 

If zero or more characters at the beginning of string match this regular 
expression, returns a corresponding MatchObject instance. Returns None if 
the string does not match the pattern; note that this is different from a 
zero-length match. 

The optional second parameter pos gives an index in the string where the 
search is to start; it defaults to 0. This is not completely equivalent to 
slicing the string; the " pattern character matches at the real beginning of 
the string and at positions just after a newline, but not necessarily at the 
index where the search is to start. 

The optional parameter endpos limits how far the string will be searched; it 
will be as if the string is endpos characters long, so oniy the characters 
from pos to endpos will be searched for a match. 

search(sfr/ng[, pos][, endpos]) 

Scans through string looking for a location where this regular expression 
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produces a match, and returns a corresponding Matchobject instance. 
Returns None if no position in the string matches the pattern; note that this 
is different from finding a zero-length match at some point in the string. 

The optional pos and endpos parameters have the same meaning as for 
the match 0 method. 

split(sfr/ng[, maxsplit=0]) 

Identical to the spiit () function, using the compiled pattern. 

findall(sfr/ng[, pos[, endpos]]) 

Identical to the findaii () function, using the compiled pattern. 

finditer(sfr;ng[, pos[, endpos]]) 

Identical to the finditer o function, using the compiled pattern. 

sub(rep/, string[, count=0]) 

Identical to the subO function, using the compiled pattern. 

subn(rep/, string[, count=0]) 

Identical to the subno function, using the compiled pattern. 


Match Objects 

Match objects are returned by the match & search functions. 


Match object attributes 

Attribute 

Descriptiori 

pos 

Value of pos passed to search or match functions; index into string at which RE engine started search. 

endpos 

Value of endpos passed to search or match functions; index into string beyond which RE engine won't 
go. 

re 

RE object whose match or search fct produced this Matchobj instance. 

string 

String passed to match () or search () . 


Match object methods 

Method 

Resuit 

group([gI, g2, ...]) 

Returns one or more groups of the match. If one arg, resuit is a string; if multiple 
args, resuit is a tuple with one item per arg. If gi is 0, returns the entire matching 
string; if 1 <= gi <= 99, returns string matching group #gi (or None if no such 
group); gi may also be a group name. 

groupsO 

Returns a tuple of all groups of the match; groups not participating to the match have 
a value of None. Returns a string instead of tuple if len(tuple) = = 1. 

start(group), end(group) 

Returns indices of start & end of substring matched by group (or None if group exists 
but didn't contribute to the match). 

span(group) 

Returns the 2-tuple (start(group), end(group)); can be (None, None) if group didn't 
contibute to the match. 


math 

For complex number functions, see module cmath. For intensive number crunching, see Numerical Python and the 
Python and Scientific computing page. 


Constants 

Name 

Value 

Pi 

3.1415926535897931 

e 

2.7182818284590451 


Functions 

Name 

Resuit 

acos(x) 

Returns the arc cosine (measured in radians) of x. 

acosh(x) 

Returns the hyperbolic arc cosine (measured in radians) of x. 

asin(x) 

Returns the arc sine (measured in radians) of x. 

asinh(x) 

Returns the hyperbolic arc sine (measured in radians) of x. 

atan(x) 

Returns the arc tangent (measured in radians) of x. 

atan2(/, x) 

Returns the arc tangent (measured in radians) of y/x. The resuit is between -pi and pi. 

Uniike atan (y/x) , the signs of both x and y are considered. 

atanh(x) 

Returns the hyperbolic arc tangent (measured in radians) of x. 

ceil(x) 

Returns the ceiling of x as a fioat. This is the smallest integral value >= x. 

copysign(x, y) 

Copies the sign bit of an IEEE 754 number, returning the absolute value of x combined with 
the sign bit of y, e.g. copysign (1, -o.O) returns-i.o. 

cos(x) 

Returns the cosine of x (measured in radians). 

cosh(x) 

Returns the hyperbolic cosine of x. 
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degrees(x) 

Converts anqle x from radians to deqrees. 

exp(x) 

Returns e raised to the power of x. 

fabs(x) 

Returns the absolute value of the float x. 

factorial(r)) 

returns n ! 

floor(x) 

Returns the floor of x as a float. This is the largest integral value <= x. 

fmod(x, y) 

Returns fmodfx, y), accordinq to platform C. x % y may differ. 

frexp(x) 

Returns the mantissa and exponent of x, as pair (m, e) . m is a float and e is an int, such 
that X = m * 2.**e. If x is 0, m and e are both 0. EIse 0.5 <= abs(m) < 1.0. 

fsum(/fera6/e) 

Returns an accurate floating point sum of values in iterable (assumes IEEE-754 floating 
point arithmetic). 

hypot(x, y) 

Returns the Euclidean distance sqrt (x*x + y*y). 

isinf(x) 

Returns True if x is infinite (positive or neqative). 

isnan(x) 

Returns True if x is not a number. 

ldexp(x, /) 

X * (2**i) 

log(x[, base]) 

Returns the logarithm ofxto the given base. If the base is not specified, returns the natural 
loqarithm (base e) of x. 

loqlO(x) 

Returns the base 10 logarithm of x. 

loglp(x) 

Returns the natural logarithm of 1+x (base e). The resuit is computed in a way which is 
accurate for x near zero. 

modf(x) 

Returns the fractional and integer parts of x. Both results carry the sign of x. The integer 
part is returned as a float. 

pow(x, y) 

Returns x**y (x to the power of y). Note that for y=2, it is more efficient to use x*x. 

radians(x) 

Converts anqle x from deqrees to radians. 

sin(x) 

Returns the sine (measured in radians) of x. 

sinh(x) 

Returns the hyperbolic sine of x. 

sqrt(x) 

Returns the square root of x. 

tan(x) 

Returns the tanqent (measured in radians) of x. 

tanh(x) 

Returns the hyperbolic tanqent of x. 

trunc(x) 

Returns the Reai value x truncated to an integral. Delegates to x.tmnc(). 


getopt 

Parser for command line options. 

This was the Standard parser untii Python 2.3, now superseded by optparse. 

[see also: Richard Gruefs simple parser getargs.py (shameless self promotiori)] 

Functions: 

getopt(list, optstr) — Similar to C. <optstr> is option letters to look for. 

Put after letter if option takes arg. E.g. 

# invocation was "python test.py -c hi -a argl arg2" 

opts, args = getopt.getopt(sys.argv[1:], 'ab:c:') 

# opts would be 

[ {'-c', 'hi'), {'-a', '')] 

# args would be 

[ 'argl', 'arg2'] 


List of modules and packages in base distribution 

Built-ins and content of python Lib directory. The subdirectory Lib/site-packages contains platform-specific 
packages and modules. 

[Main distributions (Windows, Unix), some OS specific modules may be missing] 


Standard library modules 

Operation 

Resuit 

_builtin_ 

Provide direct access to all ' built-in' identifiers of Python, e.g._ builtin_.open 

is the full name for the built-in function open o . 

_future_ 

Future statement definitions. Used to progressively introduce new features in the 
lanquaqe. 

_main_ 

Represent the (otherwise anonymous) scope in which the interpreter's main 
program executes -- commands read either from Standard input, from a script 


Page 42 of 50 








































Python 2.6 Quick Reference 


file, or from an interactive prompt. Typical idiom to check if a code was run as a 
script (as opposed to being imported)-. 

if _name_ == '_main_' : 

mainO # (this code was run as script) 



abc 

(new in 2.6) Abstract Base Classes (ABC) [PEP 3119]. Equivalent of Java 
interfaces. The module collections defines interfaces/ABCs for many 
behaviors/protocols/data structures (iterable, Hashable, Sequence, Set, etc...). 

aifc 

Stuff to parse AIFF-C and AIFF files. 

anydbm 

Generic interface to all dbm dones, (dbhash, gdbm, dbm, dumbdbm). 

array 

Efficient arrays of numeric values. 

a st 

(new in 2.6) Flelpers to process Trees of the Python Abstract Syntax grammar. 

asynchat 

A class supporting chat-style (command/response) protocols. 

asyncore 

Basic infrastructure for asynchronous Socket Service clients and servers. 

atexit 

Reqister functions to be called at exit of Python interpreter. 

audiodev 

Classes for manipulating audio devices (currently oniy for Sun and SGI). 

Deprecated since 2.6. 

audioop 

Manipulate raw audio data. 2.5: Supports the a-tAW encoding. 

base64 

Conversions to/from base64 transport encoding as per RFC-1521. 


FITTP server base class 

Dostion 


bdb 

A generic Python debuqqer base class. 

binascii 

Convert between binary and ASCII. 

binhex 

Macintosh binhex compression/decompression. 

bisect 

Bisection algorithms. 

bsddb 

(Optional) improved BSD database interface [package]. 

bz2 

BZ2 compression. 

calendar 

Calendar printinq functions. 

egi 

Wraps the WWW Forms Common Gateway Interface (CGI). 

CGIHTTPServer 

CGI-savvy FITTP Server. 

egitb 

Traceback manager for CGI Scripts. 

chunk 

Read IFF chunked data. 

cmath 

Mathematical functions for complex numbers. See also math. 

emd 

A generic class to build line-oriented command interpreters. 

emp 




em pcucnt 
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j 

t 

i 
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code 

Utilities needed to emulate Python's interactive interpreter. 

codecs 

Lookup existing Unicode encodings and register new ones. 2.5: support for 
incremental codecs. 

codeop 

Utilities to compile possibly incomplete Python source code. 

collections 

high-performance Container datatypes. 2.4: The oniy datatype defined is a 
double-ended queue deque. 2.5: Type deque has now a remove method. New 
type defauitdict. 2.6: New type namedtupie. Define many ABCs (Abstract Base 
Classes) like Container, Flashable, Iterable, Sequence, Set... 

colorsys 

Conversion functions between RGB and other color Systems. 

commands 

Exeeute Shell commands via os.popen fUnix]. 

compileall 

Force "compilation" of all .py files in a directory. 

ConfigParser 

Configuration file parser (much like Windows .ini files). 

contextiib 

Utilities for with statement contexts. 

Cookie 

HTTP state (cookies) management. 

copy 

Generic shallow and deep copyinq operations. 

copy req 

Helper to provide extensibility for modules pickle/cPickle. 

cPickle 

Faster, C implementation of pickle. 

cProfile 

Faster, C implementation of profile. 

crypt 

Function to check Unix passwords [Unix]. 

cStringlO 

Faster, C implementation of StringlO. 

csv 

Tools to read comma-separated files (of variations thereof). 2.5: Several 
enhancements. 

ctypes 

"Foreign function" library for Python. Provides C compatible data types, and 
allows to call functions in dlls/shared libraries. Can be used to wrap these libraries 
in pure Python. 

curses 

Terminal handiing for character-cell displays [Unix/OS2/DOS oniy]. 



datetime 


Improved date/time types (date, time, datetime, timedeita). 2.5: New method 
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strptime (string, format) for class datetime. 2.6: strftimeO new format 


dbhash 

(g)dbm-compatible interface to bsdhash.hashopen. 

decimal 

Decimal floatinq point arithmetic. 

difflib 

Tool for comparing sequences, and computing the changes required to conyert 
one into another. 2.5: Improyed SeguenceMatcher . get_matching_blocks () 
method . 

dircache 

Sorted list of files in a dir, using a cache. Deprecated since 2.6. 

dircmp 

Dcfincs 0 class to build directory diff tools on. 



distutiis.command.register 


distutiis.debug _ 

distutiis.emxccom piler 


distutiis.lo 


dl 


doctest 


DocXMLRPCServer 


dummy thread 


dummy_threading 


encodings 


exceptions 


fcnti 


filecm 


fileinput 


I M IU 


fnmatch 


formatter _ 

fpecti 


fpformat 


fractioris 


ftplib 


functools 


future_builtins 


i 


dbm 


getopt 


Bytecode disassembler._ 


Package installation system. 2.5: Function setup enhanced with new keyword 
parameters requires, provides, obsoletes, and download_url [PEP314]. 


Registers a module in the Python package index (PyPI). This command plugin 
adds the register command to distutii Scripts._ 


Call C functions in shared objects [Unix]. Deprecated since 2.6. 


Unit testing framework based on running examples embedded in docstrings. 2.5: 
New SKip option. New encoding arg to testfiieo function. 


Creation of seif-documenting XML-RPC servers, using pydoc to create HTML API 
doc on the fly. 2.5: New attribute rpc_paths. 



A dumb and siow but simple dbm clone. 



Helpers to make it easier to write code that uses threads where supported, but 
stili runs on Python yersions without thread support. The dummy modules simply 
run the threads sequentially._ 


A package for parsing, handiing, and generating emaii messages. New yersion 
3.0 dropped various deprecated APIs and remoyes support for Python yersions 
earlier than 2.3. 2.5: Updated to version 4.0._ 


New codecs: idna (IDNA strings), koi8_u (Ukranian), palmos (PalmOS 3.5), 
punycode (Punycode IDNA codec), string_escape (Python string escape codec: 
replaces non-printable chars w/ Python-style string escapes). New codecs in 2.4: 
HP RomanS, ISO_8859-ll, ISO_8859-16, PCTP-154, TIS-620; Chinese, Japanese 
and Korean codecs. 


Standard errno system symbols. The value of each Symbol is the corresponding 

integer value. _ 

Class based built-in exception hierarchy. 


The fcnti 0 and ioctio system calls [Unix]. 


File and directory comparison. 


Helper class to quickly write a loop oyer ali Standard input files. 2.5: Made more 
flexible (Unicode filenames, mode parameter, etc...)_ 


mh2U9U'^uu2I39 


Filename matching with shell patterns._ 


Generic output formatting. _ 

Floatinq point exception controi [Unix]. 


General floatinq point formattinq functions. Deprecated since 2.6. 


(new in 2.6) Rational Numbers. 


An FTP Client class. Based on RFC 959. 


Tools for functional-style programming. See in particular function partiai () 
[PEP309]. 


(new in 2.6) Python 3 builtins. Proyides functions that exist in 2.x, but have 
different behayior in Python 3 (ascii, map, filter, hex...). To write Python 3 
compatible code, import the fcts from this module, e.g.: 

from future_builtins import map 
...code using Python3-syle map()... 


Perform garbage collection, obtain GC debug stats, and tune GC parameters. 2.5: 
New get_count () function. gc.coiiect () takes a new generation argument. 


GNU's reinterpretation of dbm [Unix 


Standard command line Processing. See also optparse. 
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m 


getpass 

ettext 


lob 


grp_ 




gzip _ 

hashiib _ 

heapq 


hmac 


hotshot.stones 


htmientitydefs 


htmilib 


HTMLParser 

httplib 


idielib 


ihooks 


imageop 


imaplib 


json 


keyword 


kncc 

linecache 


Utilities to get a password and/or the current user name. 
Internationalization and localization support. 


Filename "globbing" utilit 


The group database [Unix]. 





Read & write gzipped files. _ 

Secure hashes and message digests. _ 

Heap queue (priority queue) helpers. 2.5: nsmaiiest () and niargest () takes a 
key keyword param. 


HMAC (Keyed-Hashinq for Messaqe Authentication 


stone benchmark under the Hotshot profiler. 


HTML character entity references._ 


HTML2 parsing Utilities_ 


Simple HTML and XHTML parser. _ 

HTTPl Client class. 


ackaqe) Support library for the IDLE development environment. 


Hooks into the "import" mechanism. Deprecated since 2.6. 


Manipulate raw image data. Deprecated since 2.6. 


IMAP4 Client. Based on RFC 2060. 


Recognizing image files based on their first few bytes. _ 

Access the import internals. 


Provides a way of writing customized import hooks. 


Get Information about live Python obiects. 


(new in 2.6) Core tools for working with streams [PEP 3116]. Define Abstract 
Base Classes RawioBase (I/O operations: read, write, seek..), BufferediOBase 
(buffering), and xextiOBase (reading & writing strings). 


Tools to work with iterators and Iazy sequences. 2.5: isiice () accepts None for 
start & step args. 2.6: Several new functions: izip_iongest, product, 
combinations, permutations. 


(new in 2.6) JSON (JavaScript Object Notation) interchange format support. 


List of Python keywords. 



Cache lines from files. 


Replaced by ossaudiodev(Linux). 


Support for number formatting using the current locale settings. 2.5: format () 
modified; new fcts format_string () and currency () 


ackaoej Tools for structured logging in log4i style. 


macpath 

Pathname (or related) operations for the Macintosh [Mac]. 

macurl2path 

Mac specific module for conversion between pathnames and URLs [Mac]. 

mailbox 

Classes to handie Unix style, MMDF style, and MH style mailboxes. 2.5: added 
capability to modify mailboxes in addition to reading them. 

mailcap 

Mailcap file handiing (RFC 1524). 

marshal 

Internal Python object serialization. 

markupbase 

Shared support for scanning document type declarations in HTML and XHTML. 

math 

Mathematical functions. See also cmath 

md5 

MD5 message digest algorithm. 2.5: Now a mere wrapper around new library 
hashiib. Deprecated since 2.6, use hashiib module instead. 

mhlib 

MH (mailbox) interface. Deprecated since 2.6. 

mimetools 

Various tools used by MIME-reading or MIME-writing programs. Deprecated since 
2.6. 

mimetypes 

Guess the MIME type of a file. 

MimeWriter 

Generic MIME writer. Deprecated since 2.3, use emaii package instead. 

mimify 

Mimification and unmimification of mali messages. Deprecated since 2.6, use 
emaii package instead. 

mmap 

Interface to memory-mapped files - they behave like mutable strings. 

modulefinder 

Tools to find what modules a given Python program uses, without actually 
running the program. 

msilib 

Read and write Microsoft Installer files [Windows]. 

msvcrt 

File & Console Windows-specific operations [Windows]. 

multifile 

A readline()-style interface to the parts of a multipart message. Deprecated since 
2.6. 
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multiprocessing 


(new in 2.6) Process-based "threading" interface. Allows to fully leverage 

multiple processors on a machine [Windows, Unix] [PEP 371]. _ 

Mutuai exciusion -- for use with moduie sched. See aiso std moduie threading, 
and giock._ 


new 

Creation of runtime internai objects (interface to interpreter object creation 
functions). Deprecated since 2.6. 

nis 

Interface to Sun's NIS (Yeiiow Pages) [Unix]. 2.5: New domain arg to nis.match 

0 and nis .maps () . 

nntplib 

An NNTP ciient ciass. Based on RFC 977. 

ntpath 

Common operations on Windows pathnames [Windows]. 

nturi2path 

Convert a NT pathname to a fiie URL and vice versa [Windows]. 

numbers 

(new in 2.6) Numeric Abstract Base Classes (ABC) [PEP 3141]. Define a type 

hierarchy for numbers: Number, complex, Real, Rational, Integral. 

oiddiffiib 

Oid version of difflib (heipers for computinq deitas between objects)? 

operator 

Standard operators as functions. 2.5: itemgettero and attrgettero now 
supports muitipie fieids. 

optparse 

Improved command-line option parsing library (see aiso getopt). 2.5: Updated to 
Optik library 1.51. 

OS 

OS routines for Mac, DOS, NT, or Posix depending on what system we're on. 2.5: 
os. stato return time vaiues as fioats; new constants to os. iseek o ; new 
functions wait3 () and wait4 (); on FreeBSD, os. stat () returns times with 
nanosecond resoiution. 

os.path 

Common pathname manipuiations. 

os2emxpath 

os.path support for OS/2 EMX. 




ickietoois 


pipes 


pkgutii 


piatform 


poiy _ 

popen2 


posix 


posixfiie 


posixpath 


pprint 

pre 

profiie 

pstats 


wd 


py_compiie 


pycibr_ 


PyUn i t 


Queue 


rand 


random 



Access Python parse trees. _ 

A Python debuqqer. 


Pickiing (save/seriaiize and restore/deseriaiize) of Python objects (a faster C 
impiementation exists in buiit-in moduie: cPickie). 2.5: Vaiue returned by 
_reduce _() must be different from None. 


Toois to anaiyze and disassembie pickies. 


Conversion pipeline tempiates [Unix]. 


Toois to extend the moduie search path for a given package. 2.5: PEP302's 
import hooks support; works for packages in ZIP format archives._ 


Get info about the underiying piatform._ 


Po l ynom i a i s. _ 

Spawn a command with pipes to its stdin, stdout, and optionaiiy stderr. 
Superseded by moduie subprocess since 2.4. Deprecated since 2.6. 


A POP3 ciient ciass. 


Most common POSIX system caiis [Unix]._ 


(deprecated since 1.5, use fcnti.iockf () instead) Fiie-iike objects with 
iocking support [Unix]._ 


Common operations on POSIX pathnames._ 


Support to pretty-print iists, tupies, & dictionaries recursiveiy. _ 

Support for reguiar expressions (RE) - see re. 

Ciass for profiling python code. 2.5: See aiso new fast C impiementation 

cProfile 

Ciass for printing reports on profiied python code. 2.5: new stream arg to stats 
constructor. 


Pseudo terminai utiiities [Linux, IRIX 


The password database [Unix 


Routine to "compiie" a .py fiie to a .pyc fiie._ 


Parse a Python fiie and retrieve ciasses and methods._ 


Generate Python documentation in HTML or text for interactive use. _ 

Interface to the Expat XML parser. 2.5: now uses V2.0 of the expat parser. 


See unittest. 


A muiti-producer, muiti-consumer queue. 2.6: New queue variants 

PriorityQueue and LifoQueue. 


Conversions to/from quoted-printabie transport encoding as per RFC 1521. 


Don't use uniess you want compatibiiity with C's randQ._ 


Random variabie generators._ 
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rcgsub 

Rcqcxp bosed split and rcplacc usinq the obsolete rcqcx module. 

repr 

Alternate repr 0 implementation. 

resource 

Resource usaqe Information fUnixl. 



rfc822 

1 Parse RFC-8222 mali headers. 



ricompleter 

Word completion for GNU readiine 2.0 [Unix]. 2.5: Doesn't depend on readiine 
anymore; now works on non-Unix platforms. 

robotparser 

Parse robot.txt files, usefui for web spiders. 

sched 

A qenerally usefui event scheduler class. 

select 

Waitinq for I/O completion. 

sets 

A Set datatype implementation based on dictionaries. Deprecated since 2.6, use 
built-in types set and frozenset instead. 

sqmllib 

A parser for SGML, usinq the derived class as a static DTD. 

sha 

SHA-1 messaqe diqest alqorithm. 2.5: Now a mere wrapper around new library 
hashiib. Deprecated since 2.6, use hashiib instead. 

shelve 

Manaqe shelves of pickled objects. 

shiex 

Lexical analyzer class for simple shell-like syntaxes. 

shutii 

Utility functions for copyinq files and directory trees. 

siqnal 

Set handiers for asynchronous events. 

SimpleHTTPServer 

Simple HTTP Server. 

SimpleXMLRPCServer 

Simple XML-RPC Server. 2.5: New attribute rpc_paths. 

site 

Append module search paths for third-party packaqes to sys.path. 

smtpd 

An RFC 2821 SMTP server. 

smtplib 

SMTP/ESMTP Client class. 

sndhdr 

Several routines that help recoqnizinq sound. 

Socket 

Socket operations and some related functions. Now supports timeouts thru 
function settimeout (t) . Also supports SSL on Windows. 2.5: Now supports 
AF_NETLiNK sockets 00 Lioux; new Socket methods recv_buf (buTTer), 
recvfrom_buf(buffer), getfamily(), gettype () and getproto() . 

SocketServer 

Generic Socket server classes. 

spwd 

Access to the UNIX shadow password database [Unix]. 

sqliteS 

DB-API 2.0 interface for SQLIte databases. 

sre 

Support for requiar expressioris (RE). See re. 

stat 

Constants/functions for interpretinq results of os. 

statcache 

Maintain a cache of stat () Information on files. 

statvfs 

Constants for interpretinq statvfs struet as returned by os.statvfs () and 
os. fstatvfs 0 (if they exist). Deprecated since 2.6. 

strinq 

A collectiori of strinq operations (see Strinqs). 

StrinqlO 

File-like objects that read/write a strinq buffer (a faster C implementation exists 
in built-in module cStrinqlO). 

strinqprep 

Normalization and manipulation of Unicode strinqs. 

struet 

Perform conversions between Python values and C structs represented as Python 
strinqs. 2.5: faster (new pack () and unpacko methods); pack and unpack to 
and from buffer objects via methods pack_into and unpack_froin. 

subprocess 

Subprocess manaqement. Replacement for os.system, os.spawn*, os.popen*, 
popen2.* [PEP3241 

sunau 

Stuff to parse Sun and NeXT audio files. 

sunaudio 

Interpret sun audio headers. 

Symbol 

Non-terminal symbois of Python qrammar (from "qraminit.h"). 

symtable 

Interface to the compiler's internal Symbol tables. 


System-specific parameters and functions. 

sysloq 

Unix sysloq library routines [Unix]. 

tabnanny 

Check Python source for ambiquous indentation. 

tarfile 

Tools to read and create TAR archives. 2.5: New method TarFiie.extractaii (). 




teinetiib 

TELNET Client class. Based on RFC 854. 

tempfile 

Temporary files and filenames. 2.6: New classes spooiedTemporaryFiie and 
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NamedTemporaryFile. 



termios 

POSIX style tty controi [Unix]. 

test 

Regression tests packaqe for Python. 

textwrap 

Tools to wrap paraqraphs of text. 

thread 

Multiple threads of controi (see also threading below). 

th reading 

New threading module, emulating a subset of Java's threading model. 2.5: New 
function stack_size ([size] ) allows to get/set the stack size for threads created. 
2.6: Several functions renamed or replaced by properties, new property 

Thread. ident . See also new module multiprocessing. 

threading_api 

(doc of the threading module). 

time 

Time access and conversions. 

timeit 

Benchmark tool. 

Tix 

Extension widqets forTk. 

Tkinter 

Python interface to Tcl/Tk. 

toaiff 

Convert "arbitrary" sound files to AIFF (Apple and SGTs audio format). 

Deprecated since 2.6. 

token 

Token constants (from "token.h"). 

tokenize 

Tokenizer for Python source. 

trace 

Tools to trace execution of a function or program. 

traceback 

Extract, format and print Information about Python stack traces. 

tty 


turtie 

LoqoMation-like turtIe qraphics. 

types 

Define names for ali type symbois in the std interpreter. 

tzparse 

Parse a timezone specification. 

unicodedata 

Interface to Unicode properties. 2.5: Updated to Unicode DB 4.1.0; Version 3.2.0 
stili available as unicodedata.ucd_3_2_o. 2.6: Updated to Unicode DB 5.1.0. 

unittest 

Python unit testing framework, based on Erich Gamma's and Kent Beck's JUnit. 

urilib 

Open an arbitrary URL. 

urllib2 

An extensible library for openinq URLs usinq a variety of protocols. 

uriparse 

Parse (absolute and relative) URLs. 

user 

Flook to allow user-specified customization code to run. 

UscrDIct 

A wrapper to allow subclassing of built-in dict class (useless with new-style 
classes. Since Python 2.2, dict is subclassable). 

UscrList 

A wrapper to allow subclassing of built-in list class (useless with new-style 
classes. Since Python 2.2, list is subclassable) 

UscrString 

A wrapper to allow subclassing of built-in string class (useless with new-style 
classes. Since Python 2.2, str is subclassable). 


somc uscfui functions thot don't fit eisewhcre !! 

uu 

Implementation of the UUencode and UUdecode functions. 

uuid 

UUID objects according to RFC 4122. 

warnings 

Python part of the warnings subsystem. Issue warnings, and filter unwanted 
warnings. 

wave 

Stuff to parse WAVE files. 

weakref 

Weak reference support for Python. Also allows the creation of proxy objects. 2.5: 
new methods iterkeyrefs (), keyrefs (), itervaluerefs () and valuerefs (). 

webbrowser 

Platform independent URL launcher. 2.5: several enhancements (more browsers 
supported, etc...). 


Several routines thot help reeoqnizinq sound files. 

whichdb 

Guess which db packaqe to use to open a db file. 

whrandom 

Wichmann-Flill random number generator (obsolete, use random instead). 

winsound 

Sound-playing interface for Windows [Windows]. 

wsgiref 

WSGI Utilities and Reference Implementation. 

xdriib 

Implements (a subset of) Sun XDR (eXternal Data Representation). 

xmllib 

A parser for XML, usinq the derived class as static DTD. 

xml.dom 

Classes for Processing XML using the DOM (Document Object Model). 2.3: New 
modules expatbuilder, minicompat, NodeFilter, xmibuilder. 

xml.etree.ElementTree 

Subset of Fredrik Lundh's ElementTree library for Processing XML. 

xml.parsers.expat 

An interface to the Expat non-validating XML parser. 

xml.sax 

Classes for Processing XML using the SAX API. 

xmirpclib 

An XML-RPC Client interface for Python. 2.5: Supports returning datetime objects 
for the XML-RPC date type. 



xreadiines 


Provides a sequence-like object for reading a file line-by-line without reading the 
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entire file into memory. Deprecated since release 2.3. Use for line in file 
instead. Removed since 2.4 

zipfile 

Read & write PK zipped files. 2.5: Supports ZIP64 version, a .zip archive can now 
be larger than 4GB. 2.6: Class zipFiie has new methods extract () and 
extractall() . 

zipimport 

ZIP archive Importer. 

zlib 

Compression compatible with gzip. 2.5: compress and Decompress objects now 
support a copyO method. 


II* /“II II 1*1 1^ 



Workspace exploratiori and idiom hints 


dir( object) 

llst valld attributes of object (which can be a module, type or class 
obiect) 

dir 0 

llst names In current local Symbol table. 

if _name_ == ' main_ ' : 

main () 

Invoke main() If running as script 

inap(None, Isti, lst2, ...) 

merge lists; see also zlpflstl, Ist2, ...) 

b = a [ : ] 

create a copy b of sequence a 

b = list(a) 

If a Is a llst, create a copy of It. 

a,b, c = 1,2,3 

Multiple assignment, same as a = l; b=2; c=3 

for key, value in dic.itemsO : 

Works also In thIs context 

if 1 < X <= 5: ... 

Works as expected 

for line in fileinput.input(): 

Process each file In command line args, one line at a time 

_ 

(underscore) in interactive mode, refers to the last value printed. 


Python Mode for Emacs 

Emacs goodies available here. 

(The following has not been revised, probably not up to dabe - any contribution welcome -) 


Type C-c ? when in python-mode for extensive help. 
INDENTATION 


Primarily for entering new code: 

TAB indent line appropriately 

LFD insert newline, then indent 

DEL reduce indentation, or delete single character 

Primarily for reindenting existing code: 

C-c : guess py-indent-offset from file content; change 

C-u C-c : ditto, but change globally 

C-c TAB reindent region to match its context 
C-c < shift region left by py-indent-offset 

C-c > shift region right by py-indent-offset 

MARKING & MANIPULATING REGIONS OF CODE 


C-c C-b 
M-C-h 
C-U M-C-h 
C-c # 

C-u C-c # 
MOVING POINT 


mark block of lines 
mark smallest enclosing def 
mark smallest enclosing class 
comment out region of code 
uncomment region of code 


C-c C-p move to statement preceding point 

C-c C-n move to statement following point 

C-c C-u move up to start of current block 

M-C-a move to start of def 

C-u M-C-a move to start of class 

M-C-e move to end of def 

C-u M-C-e move to end of class 

EXECUTING PYTHON CODE 


C-c C-c sends the entire buffer to the Python interpreter 
C-c I sends the current region 

C-c ! starts a Python interpreter window; this will be used by 
subsequent C-c C-c or C-c | commands 
VARIABLES 


locally 
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py-indent-offset indentation increment 

py-block-comment-prefix comment string used by py-comment-region 
py-python-command Shell command to invoke Python interpreter 

py-scroll-process-buffer t means always scroll Python process buffer 

py-temp-directory directory used for temp files (if needed) 

py-beep-if-tab-change ring the bell if tab-width is changed 


Page 50 of 50 




